# svelte/no-unnecessary-state-wrap
Disallow unnecessary $state wrapping of reactive classes
- ⚙️ This rule is included in
"plugin:svelte/recommended". - 💡 Some problems reported by this rule are manually fixable by editor suggestions.
# 📖 Rule Details
In Svelte 5, several built-in classes from svelte/reactivity are already reactive by default:
SvelteSetSvelteMapSvelteURLSvelteURLSearchParamsSvelteDateMediaQuery
Therefore, wrapping them with $state is unnecessary and can lead to confusion.
<script>
/* eslint svelte/no-unnecessary-state-wrap: "error" */
import {
SvelteSet,
SvelteMap,
SvelteURL,
SvelteURLSearchParams,
SvelteDate,
MediaQuery
} from 'svelte/reactivity';
// ✓ GOOD
const set1 = new SvelteSet();
const map1 = new SvelteMap();
const url1 = new SvelteURL('https://example.com');
const params1 = new SvelteURLSearchParams('key=value');
const date1 = new SvelteDate();
const mediaQuery1 = new MediaQuery('(min-width: 800px)');
// ✗ BAD
const set2 = $state(new SvelteSet());
const map2 = $state(new SvelteMap());
const url2 = $state(new SvelteURL('https://example.com'));
const params2 = $state(new SvelteURLSearchParams('key=value'));
const date2 = $state(new SvelteDate());
const mediaQuery2 = $state(new MediaQuery('(min-width: 800px)'));
</script>
# 🔧 Options
{
"svelte/no-unnecessary-state-wrap": [
"error",
{
"additionalReactiveClasses": [],
"allowReassign": true
}
]
}
additionalReactiveClasses… An array of class names that should also be considered reactive. This is useful when you have custom classes that are inherently reactive. Use the local name used to construct the class, including any import alias. Default is[].allowReassign… Allows$statewrapping when the variable is reassigned (includingbind:). Can be a boolean or an array of class names. Default istrue.true… Allows it for all reactive classes.false… Never allows it. Update the value with its methods (e.g.set.clear()) instead of reassigning it.- An array … Allows it only for the listed classes. For built-in classes from
svelte/reactivity, use the original export name (e.g.SvelteSet) even if the import is aliased. For custom classes, use the same local name as inadditionalReactiveClasses.
# Examples with Options
# additionalReactiveClasses
<script>
/* eslint svelte/no-unnecessary-state-wrap: ["error", { "additionalReactiveClasses": ["MyReactiveClass"] }] */
import { MyReactiveClass } from './foo';
// ✓ GOOD
const myState1 = new MyReactiveClass();
// ✗ BAD
const myState2 = $state(new MyReactiveClass());
</script>
# allowReassign
<script>
/* eslint svelte/no-unnecessary-state-wrap: ["error", { "allowReassign": true }] */
import { SvelteSet, SvelteMap } from 'svelte/reactivity';
// ✓ GOOD
let set1 = $state(new SvelteSet());
set1 = new SvelteSet([1, 2, 3]); // Variable is reassigned
let map1 = $state(new SvelteMap());
map1 = new SvelteMap([['key', 'value']]); // Variable is reassigned
// ✗ BAD
const set2 = $state(new SvelteSet()); // const cannot be reassigned
let set3 = $state(new SvelteSet()); // Variable is never reassigned
</script>
<script>
/* eslint svelte/no-unnecessary-state-wrap: ["error", { "allowReassign": false }] */
import { SvelteSet } from 'svelte/reactivity';
// ✓ GOOD
const set1 = new SvelteSet();
set1.clear(); // Update with methods instead of reassigning
// ✗ BAD
let set2 = $state(new SvelteSet());
set2 = new SvelteSet(); // Reassignment is not allowed
</script>
<script>
/* eslint svelte/no-unnecessary-state-wrap: ["error", { "allowReassign": ["SvelteSet"] }] */
import { SvelteSet, SvelteMap } from 'svelte/reactivity';
// ✓ GOOD
let set = $state(new SvelteSet());
set = new SvelteSet([1, 2, 3]); // SvelteSet is in allowReassign and variable is reassigned
// ✗ BAD
let map = $state(new SvelteMap()); // SvelteMap is not in allowReassign
map = new SvelteMap();
const set2 = $state(new SvelteSet()); // const cannot be reassigned
let set3 = $state(new SvelteSet()); // Variable is never reassigned
</script>
For example, when a custom class is imported with an alias, use the alias in both options:
<script>
/* eslint svelte/no-unnecessary-state-wrap: ["error", { "additionalReactiveClasses": ["Alias"], "allowReassign": ["Alias"] }] */
import { CustomReactiveClass as Alias } from './custom';
// ✓ GOOD
let value = $state(new Alias());
value = new Alias();
</script>
# 🚀 Version
This rule was introduced in eslint-plugin-svelte v3.2.0