W3cubDocs

/Dart 2

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

isEmptybool
read-only
isNotEmptybool
read-only
keysIterable<String>
read-only
lengthint
read-only
valuesIterable<String>
read-only
entriesIterable<MapEntry<String, String>>
read-only, inherited
The map entries of this.
hashCodeint
read-only, inherited
The hash code for this object. [...]
runtimeTypeType
read-only, inherited
A representation of the runtime type of the object.

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
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
operator []=(String key, String value) → void
operator ==(dynamic other) → bool
inherited
The equality operator. [...]

© 2012 the Dart project authors
Licensed under the Creative Commons Attribution-ShareAlike License v4.0.
https://api.dartlang.org/stable/2.0.0/dart-html/Storage-class.html