Alexander Thomas
5b1e226fc6
The old site supported api.dart.dev/stable/<page in the latest version> links. These currently don't work, but the correct link omits the `/stable/` path component. Even if we add redirects to make the old URLs work, we still want to update sources with the canonical URLs. CoreLibraryReviewExempt: Documentation change only. Fixes: https://github.com/dart-lang/sdk/issues/57110 Change-Id: I0b20bfa875db5ce62362a02e884d7d43b0efc73e Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/395961 Commit-Queue: Ivan Inozemtsev <iinozemtsev@google.com> Reviewed-by: Ivan Inozemtsev <iinozemtsev@google.com> Commit-Queue: Alexander Thomas <athom@google.com> Auto-Submit: Alexander Thomas <athom@google.com>
85 lines
2.4 KiB
Plaintext
85 lines
2.4 KiB
Plaintext
// Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file
|
|
// for details. All rights reserved. Use of this source code is governed by a
|
|
// BSD-style license that can be found in the LICENSE file.
|
|
|
|
part of $LIBRARYNAME;
|
|
|
|
/**
|
|
* 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](https://api.dart.dev/dart-core/Map-class.html) APIs
|
|
* such as containsValue(), clear(), and length:
|
|
*
|
|
* assert(window.localStorage.containsValue('does not exist') == false);
|
|
* window.localStorage.clear();
|
|
* assert(window.localStorage.length == 0);
|
|
*
|
|
*/
|
|
$(ANNOTATIONS)$(NATIVESPEC)$(CLASS_MODIFIERS)class $CLASSNAME$EXTENDS
|
|
with MapMixin<String, String> {
|
|
|
|
void addAll(Map<String, String> other) {
|
|
other.forEach((k, v) { this[k] = v; });
|
|
}
|
|
|
|
// TODO(nweiz): update this when maps support lazy iteration
|
|
bool containsValue(Object$NULLABLE value) => values.any((e) => e == value);
|
|
|
|
bool containsKey(Object$NULLABLE key) =>
|
|
_getItem(key $#NULLSAFECAST(as String)) != null;
|
|
|
|
String$NULLABLE operator [](Object$NULLABLE key) => _getItem(key $#NULLSAFECAST(as String));
|
|
|
|
void operator []=(String key, String value) { _setItem(key, value); }
|
|
|
|
String putIfAbsent(String key, String ifAbsent()) {
|
|
if (!containsKey(key)) this[key] = ifAbsent();
|
|
return this[key] $#NULLSAFECAST(as String);
|
|
}
|
|
|
|
String$NULLABLE remove(Object$NULLABLE key) {
|
|
final value = this[key];
|
|
_removeItem(key $#NULLSAFECAST(as String));
|
|
return value;
|
|
}
|
|
|
|
void clear() => _clear();
|
|
|
|
void forEach(void f(String key, String value)) {
|
|
for (var i = 0; true; i++) {
|
|
final key = _key(i);
|
|
if (key == null) return;
|
|
|
|
f(key, this[key]$NULLASSERT);
|
|
}
|
|
}
|
|
|
|
Iterable<String> get keys {
|
|
final keys = <String>[];
|
|
forEach((k, v) => keys.add(k));
|
|
return keys;
|
|
}
|
|
|
|
Iterable<String> get values {
|
|
final values = <String>[];
|
|
forEach((k, v) => values.add(v));
|
|
return values;
|
|
}
|
|
|
|
int get length => _length;
|
|
|
|
bool get isEmpty => _key(0) == null;
|
|
|
|
bool get isNotEmpty => !isEmpty;
|
|
$!MEMBERS
|
|
}
|