gecko-dev/dom/webidl/MutationObserver.webidl

79 lines
2.3 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/.
*
* The origin of this IDL file is
* http://dom.spec.whatwg.org
*/
[ProbablyShortLivingWrapper,
Exposed=Window]
interface MutationRecord {
[Constant]
readonly attribute DOMString type;
// .target is not nullable per the spec, but in order to prevent crashes,
// if there are GC/CC bugs in Gecko, we let the property to be null.
[Constant]
readonly attribute Node? target;
[Constant]
readonly attribute NodeList addedNodes;
[Constant]
readonly attribute NodeList removedNodes;
[Constant]
readonly attribute Node? previousSibling;
[Constant]
readonly attribute Node? nextSibling;
[Constant]
readonly attribute DOMString? attributeName;
[Constant]
readonly attribute DOMString? attributeNamespace;
[Constant]
readonly attribute DOMString? oldValue;
[Constant, Cached, ChromeOnly]
readonly attribute sequence<Animation> addedAnimations;
[Constant, Cached, ChromeOnly]
readonly attribute sequence<Animation> changedAnimations;
[Constant, Cached, ChromeOnly]
readonly attribute sequence<Animation> removedAnimations;
};
[Exposed=Window]
interface MutationObserver {
[Throws]
constructor(MutationCallback mutationCallback);
[Throws, NeedsSubjectPrincipal]
undefined observe(Node target, optional MutationObserverInit options = {});
undefined disconnect();
sequence<MutationRecord> takeRecords();
[ChromeOnly, Throws]
sequence<MutationObservingInfo?> getObservingInfo();
[ChromeOnly]
readonly attribute MutationCallback mutationCallback;
[ChromeOnly]
attribute boolean mergeAttributeRecords;
};
callback MutationCallback = undefined (sequence<MutationRecord> mutations, MutationObserver observer);
dictionary MutationObserverInit {
boolean childList = false;
boolean attributes;
boolean characterData;
boolean subtree = false;
boolean attributeOldValue;
boolean characterDataOldValue;
[ChromeOnly]
boolean chromeOnlyNodes = false;
[ChromeOnly]
boolean animations = false;
sequence<DOMString> attributeFilter;
};
dictionary MutationObservingInfo : MutationObserverInit
{
Node? observedNode = null;
};