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.

Mixes-in
Annotations
  • @Unstable()
  • @Native("Storage")

Properties

isEmpty bool
read-only
isNotEmpty bool
read-only
keys Iterable<String>
read-only
length int
read-only
values Iterable<String>
read-only
entries Iterable<MapEntry<String, String>>
The map entries of this.
read-only, inherited
hashCode int
The hash code for this object. [...]
read-only, inherited
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited

Methods

addAll(Map<String, String> other) → void
clear() → void
containsKey(Object key) bool
containsValue(Object value) bool
forEach(void f(String key, String value)) → void
putIfAbsent(String key, String ifAbsent()) String
remove(Object key) String
addEntries(Iterable<MapEntry<String, String>> newEntries) → void
Adds all key/value pairs of newEntries to this map. [...]
inherited
cast<RK, RV>() Map<RK, RV>
Provides a view of this map as having RK keys and RV instances, if necessary. [...]
inherited
map<K2, V2>(MapEntry<K2, V2> transform(K key, V value)) Map<K2, V2>
Returns a new map where all entries of this map are transformed by the given f function.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]
inherited
removeWhere(bool test(K key, V value)) → void
Removes all entries of this map that satisfy the given predicate.
inherited
toString() String
Returns a string representation of this object.
inherited
update(String key, String update(V value), { String ifAbsent() }) String
Updates the value for the provided key. [...]
inherited
updateAll(String update(K key, V value)) → void
Updates all values. [...]
inherited

Operators

operator [](Object key) String
operator []=(String key, String value) → void
operator ==(dynamic other) bool
The equality operator. [...]
inherited