dart:html
Storage class
The type used by the Window.localStorage and Window.sessionStorage properties. Storage is implemented as a Map<String, String>.
To store and get values, use Dart's built-in map syntax:
window.localStorage['key1'] = 'val1';
window.localStorage['key2'] = 'val2';
window.localStorage['key3'] = 'val3';
assert(window.localStorage['key3'] == 'val3');
You can use Map APIs such as containsValue(), clear(), and length:
assert(window.localStorage.containsValue('does not exist') == false);
window.localStorage.clear();
assert(window.localStorage.length == 0); For more examples of using this API, see localstorage_test.dart. For details on using the Map API, see the Maps section of the library tour.
- Mixed in types
- Annotations
- @Unstable()
- @Native("Storage")
Properties
- isEmpty → bool
read-only, override
- Returns true if there is no key/value pair in the map.
- isNotEmpty → bool
read-only, override
- Returns true if there is at least one key/value pair in the map.
- keys → Iterable<String>
read-only, override
- The keys of this. [...]
- length → int
read-only, override
- The number of key/value pairs in the map.
- values → Iterable<String>
read-only, override
- The values of this. [...]
- entries → Iterable<MapEntry<String, String>>
read-only, inherited
- The map entries of this.
- hashCode → int
read-only, inherited
- The hash code for this object. [...]
- runtimeType → Type
read-only, inherited
- A representation of the runtime type of the object.
Methods
- addAll(Map<String, String> other) → void
override
- Adds all key/value pairs of
other to this map. [...] - clear() → void
override
- Removes all pairs from the map. [...]
- containsKey(Object key) → bool
override
- Returns true if this map contains the given
key. [...] - containsValue(Object value) → bool
override
- Returns true if this map contains the given
value. [...] - forEach(void f(String key, String value)) → void
override
- Applies
f to each key/value pair of the map. [...] - putIfAbsent(String key, String ifAbsent()) → String
override
- Look up the value of
key, or add a new value if it isn't there. [...] - remove(Object key) → String
override
- Removes
key and its associated value, if present, from the map. [...] - addEntries(Iterable<MapEntry<String, String>> newEntries) → void
inherited
- Adds all key/value pairs of
newEntries to this map. [...] - cast<RK, RV>() → Map<RK, RV>
inherited
- Provides a view of this map as having
RK keys and RV instances, if necessary. [...] - map<K2, V2>(MapEntry<K2, V2> transform(K key, V value)) → Map<K2, V2>
inherited
- Returns a new map where all entries of this map are transformed by the given
f function. - noSuchMethod(Invocation invocation) → dynamic
inherited
- Invoked when a non-existent method or property is accessed. [...]
- removeWhere(bool test(K key, V value)) → void
inherited
- Removes all entries of this map that satisfy the given
predicate. - toString() → String
inherited
- Returns a string representation of this object.
- update(String key, String update(V value), { String ifAbsent() }) → String
inherited
- Updates the value for the provided
key. [...] - updateAll(String update(K key, V value)) → void
inherited
- Updates all values. [...]
Operators
- operator [](Object key) → String
override
- Returns the value for the given
key or null if key is not in the map. [...] - operator []=(String key, String value) → void
override
- Associates the
key with the given value. [...] - operator ==(dynamic other) → bool
inherited
- The equality operator. [...]