mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-02 15:15:23 +00:00
113 lines
3.0 KiB
Plaintext
113 lines
3.0 KiB
Plaintext
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
* You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
*/
|
|
|
|
typedef (DOMString or unsigned long) DataStoreKey;
|
|
|
|
// TODO Bug 957086 - The constructor and the setDataStoreImpl(...) will be
|
|
// removed once the DataStore API is fully rewritten in C++,
|
|
// which currently plays a role of C++ proxy directing to the
|
|
// JS codes implemented by the DataStoreImpl WebIDL.
|
|
|
|
[Func="Navigator::HasDataStoreSupport",
|
|
ChromeConstructor,
|
|
Exposed=(Window,Worker)]
|
|
interface DataStore : EventTarget {
|
|
// Returns the label of the DataSource.
|
|
[GetterThrows]
|
|
readonly attribute DOMString name;
|
|
|
|
// Returns the origin of the DataSource (e.g., 'facebook.com').
|
|
// This value is the manifest URL of the owner app.
|
|
[GetterThrows]
|
|
readonly attribute DOMString owner;
|
|
|
|
// is readOnly a F(current_app, datastore) function? yes
|
|
[GetterThrows]
|
|
readonly attribute boolean readOnly;
|
|
|
|
[Throws]
|
|
Promise<any> get(DataStoreKey... id);
|
|
|
|
[Throws]
|
|
Promise<void> put(any obj, DataStoreKey id, optional DOMString revisionId = "");
|
|
|
|
[Throws]
|
|
Promise<DataStoreKey> add(any obj, optional DataStoreKey id,
|
|
optional DOMString revisionId = "");
|
|
|
|
[Throws]
|
|
Promise<boolean> remove(DataStoreKey id, optional DOMString revisionId = "");
|
|
|
|
[Throws]
|
|
Promise<void> clear(optional DOMString revisionId = "");
|
|
|
|
[GetterThrows]
|
|
readonly attribute DOMString revisionId;
|
|
|
|
attribute EventHandler onchange;
|
|
|
|
[Throws]
|
|
Promise<unsigned long> getLength();
|
|
|
|
[NewObject, Throws]
|
|
DataStoreCursor sync(optional DOMString revisionId = "");
|
|
};
|
|
|
|
partial interface DataStore {
|
|
[ChromeOnly, Throws, Exposed=Window]
|
|
void setDataStoreImpl(DataStoreImpl store);
|
|
};
|
|
|
|
// TODO Bug 957086 - The constructor and the setDataStoreCursorImpl(...) will be
|
|
// removed once the DataStore API is fully rewritten in C++,
|
|
// which currently plays a role of C++ proxy directing to the
|
|
// JS codes implemented by the DataStoreCursorImpl WebIDL.
|
|
|
|
[Func="Navigator::HasDataStoreSupport",
|
|
ChromeConstructor,
|
|
Exposed=(Window,Worker)]
|
|
interface DataStoreCursor {
|
|
// the DataStore
|
|
[GetterThrows]
|
|
readonly attribute DataStore store;
|
|
|
|
[Throws]
|
|
Promise<DataStoreTask> next();
|
|
|
|
[Throws]
|
|
void close();
|
|
};
|
|
|
|
partial interface DataStoreCursor {
|
|
[ChromeOnly, Exposed=Window]
|
|
void setDataStoreCursorImpl(DataStoreCursorImpl cursor);
|
|
};
|
|
|
|
enum DataStoreOperation {
|
|
"add",
|
|
"update",
|
|
"remove",
|
|
"clear",
|
|
"done"
|
|
};
|
|
|
|
dictionary DataStoreTask {
|
|
DOMString revisionId;
|
|
|
|
DataStoreOperation operation;
|
|
|
|
// When |operation| is "clear" or "done", this must return null.
|
|
DataStoreKey? id;
|
|
any data;
|
|
};
|
|
|
|
// For internal use.
|
|
dictionary DataStoreRevisionData {
|
|
DOMString revisionId = "";
|
|
unsigned long objectId = 0;
|
|
DOMString operation = "";
|
|
};
|