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.

Implemented types

Properties

entries → Iterable<MapEntry<String, String>>
The map entries of this Map.
no setterinherited
hashCode → int
The hash code for this object.
no setterinherited
isEmpty → bool
Whether there is no key/value pair in the map.
no setterinherited
isNotEmpty → bool
Whether there is at least one key/value pair in the map.
no setterinherited
keys → Iterable<String>
The keys of this Map.
no setterinherited
length → int
The number of key/value pairs in the map.
no setterinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
values → Iterable<String>
The values of this Map.
no setterinherited

Methods

addAll(Map<String, String> other) → void
Adds all key/value pairs of other to this map.
addEntries(Iterable<MapEntry<String, String>> entries) → void
Adds all key/value pairs of newEntries to this map.
inherited
cast<K2, V2>() → Map<K2, V2>
Provides a view of this map as having RK keys and RV instances, if necessary.
inherited
clear() → void
Removes all entries from the map.
containsKey(Object? key) → bool
Whether this map contains the given key.
inherited
containsValue(Object? value) → bool
Whether this map contains the given value.
inherited
forEach(void f(String format, String data)) → void
Applies action to each key/value pair of the map.
inherited
map<K2, V2>(MapEntry<K2, V2> transform(String, String)) → Map<K2, V2>
Returns a new map where all entries of this map are transformed by the given convert function.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
putIfAbsent(String key, String ifAbsent()) → String
Look up the value of key, or add a new entry if it isn't there.
inherited
remove(Object? key) → String?
Removes key and its associated value, if present, from the map.
removeWhere(bool test(String key, String value)) → void
Removes all entries of this map that satisfy the given test.
retype<K2, V2>() → Map<K2, V2>
inherited
toString() → String
A string representation of this object.
inherited
update(String key, String update(String format), {String ifAbsent()?}) → String
Updates the value for the provided key.
updateAll(String update(String key, String value)) → void
Updates all values.

Operators

operator ==(Object other) → bool
The equality operator.
inherited
operator [](Object? key) → String?
The value for the given key, or null if key is not in the map.
inherited
operator []=(String key, String value) → void
Associates the key with the given value.