diff options
Diffstat (limited to 'dom/webidl/MutationObserver.webidl')
-rw-r--r-- | dom/webidl/MutationObserver.webidl | 78 |
1 files changed, 78 insertions, 0 deletions
diff --git a/dom/webidl/MutationObserver.webidl b/dom/webidl/MutationObserver.webidl new file mode 100644 index 0000000000..ae43e1b48a --- /dev/null +++ b/dom/webidl/MutationObserver.webidl @@ -0,0 +1,78 @@ +/* -*- 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; +}; |