dom/webidl/DataStore.webidl
author B2G Bumper Bot <release+b2gbumper@mozilla.com>
Mon, 09 Jun 2014 01:55:59 -0700
changeset 206796 f2a727ece81064a6e22177528aab80e816c3a377
parent 205579 d296d4109a41785e076c82c32c7d91f19be6d55c
child 218879 4685bb81ef6dc8fecc958339ce19a0888d757e6f
permissions -rw-r--r--
Bumping gaia.json for 2 gaia revision(s) a=gaia-bump ======== https://hg.mozilla.org/integration/gaia-central/rev/f2cf7db6a537 Author: Rudy Lu <me@rudy.lu> Desc: Merge pull request #19856 from RudyLu/keyboard/Bug1013570_commit Bug 1013570 - [B2G][Keyboard]Double or triple tapping on the spacebar. r=timdream. ======== https://hg.mozilla.org/integration/gaia-central/rev/499f0f82afc8 Author: Rudy Lu <me@rudy.lu> Desc: Bug 1013570 - [B2G][Keyboard]Double or triple tapping on the spacebar can result in 2-3 periods, as well as deleted characters. - Send the next key after the previous sendKey is resolved.

/* -*- 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]
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;

  // Promise<any>
  [Throws]
  Promise get(DataStoreKey... id);

  // Promise<void>
  [Throws]
  Promise put(any obj, DataStoreKey id, optional DOMString revisionId = "");

  // Promise<DataStoreKey>
  [Throws]
  Promise add(any obj, optional DataStoreKey id,
              optional DOMString revisionId = "");

  // Promise<boolean>
  [Throws]
  Promise remove(DataStoreKey id, optional DOMString revisionId = "");

  // Promise<void>
  [Throws]
  Promise clear(optional DOMString revisionId = "");

  [GetterThrows]
  readonly attribute DOMString revisionId;

  attribute EventHandler onchange;

  // Promise<unsigned long>
  [Throws]
  Promise getLength();

  [NewObject, Throws]
  DataStoreCursor sync(optional DOMString revisionId = "");
};

partial interface DataStore {
  [ChromeOnly, Throws]
  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.

[Pref="dom.datastore.enabled",
 ChromeConstructor]
interface DataStoreCursor {
  // the DataStore
  [GetterThrows]
  readonly attribute DataStore store;

  // Promise<DataStoreTask>
  [Throws]
  Promise next();

  [Throws]
  void close();
};

partial interface DataStoreCursor {
  [ChromeOnly]
  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 = "";
};