Can't use Object.defineProperty() to add an item to a DOMStringMap or Storage
[WebKit-https.git] / Source / WebCore / dom / Node.idl
1 /*
2  * Copyright (C) 2006-2016 Apple Inc. All rights reserved.
3  * Copyright (C) 2006 Samuel Weinig <sam.weinig@gmail.com>
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Library General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Library General Public License for more details.
14  *
15  * You should have received a copy of the GNU Library General Public License
16  * along with this library; see the file COPYING.LIB.  If not, write to
17  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18  * Boston, MA 02110-1301, USA.
19  */
20
21 [
22     CustomIsReachable,
23     CustomPushEventHandlerScope,
24     CustomToJSObject,
25     DOMJIT,
26     ExportMacro=WEBCORE_EXPORT,
27     JSCustomHeader,
28     JSCustomMarkFunction,
29 ] interface Node : EventTarget {
30     const unsigned short ELEMENT_NODE = 1;
31     const unsigned short ATTRIBUTE_NODE = 2;
32     const unsigned short TEXT_NODE = 3;
33     const unsigned short CDATA_SECTION_NODE = 4;
34     const unsigned short ENTITY_REFERENCE_NODE = 5; // Historical.
35     const unsigned short ENTITY_NODE = 6; // Historical.
36     const unsigned short PROCESSING_INSTRUCTION_NODE = 7;
37     const unsigned short COMMENT_NODE = 8;
38     const unsigned short DOCUMENT_NODE = 9;
39     const unsigned short DOCUMENT_TYPE_NODE = 10;
40     const unsigned short DOCUMENT_FRAGMENT_NODE = 11;
41     const unsigned short NOTATION_NODE = 12; // Historical.
42     [DOMJIT=Getter, CustomGetter] readonly attribute unsigned short nodeType;
43     readonly attribute DOMString nodeName;
44
45     readonly attribute USVString baseURI;
46
47     [EnabledAtRuntime=ShadowDOM] readonly attribute boolean isConnected;
48     [DOMJIT=Getter] readonly attribute Document? ownerDocument;
49     [EnabledAtRuntime=ShadowDOM] Node getRootNode(optional GetRootNodeOptions options);
50     [DOMJIT=Getter] readonly attribute Node? parentNode;
51     readonly attribute Element? parentElement;
52     boolean hasChildNodes();
53     readonly attribute NodeList childNodes; // FIXME: Should be [SameObject].
54     [DOMJIT=Getter] readonly attribute Node? firstChild;
55     [DOMJIT=Getter] readonly attribute Node? lastChild;
56     [DOMJIT=Getter] readonly attribute Node? previousSibling;
57     [DOMJIT=Getter] readonly attribute Node? nextSibling;
58
59     [CEReactions, SetterMayThrowException] attribute DOMString? nodeValue;
60     [CEReactions, SetterMayThrowException] attribute DOMString? textContent;
61     [CEReactions] void normalize();
62
63     [CEReactions, ImplementedAs=cloneNodeForBindings, MayThrowException, NewObject] Node cloneNode(optional boolean deep = false);
64     boolean isEqualNode(Node? other);
65     boolean isSameNode(Node? other); // Historical alias of ===.
66
67     const unsigned short DOCUMENT_POSITION_DISCONNECTED = 0x01;
68     const unsigned short DOCUMENT_POSITION_PRECEDING = 0x02;
69     const unsigned short DOCUMENT_POSITION_FOLLOWING = 0x04;
70     const unsigned short DOCUMENT_POSITION_CONTAINS = 0x08;
71     const unsigned short DOCUMENT_POSITION_CONTAINED_BY = 0x10;
72     const unsigned short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;
73     unsigned short compareDocumentPosition(Node other);
74     boolean contains(Node? other);
75
76     DOMString? lookupPrefix(DOMString? namespaceURI);
77     DOMString? lookupNamespaceURI(DOMString? prefix);
78     boolean isDefaultNamespace(DOMString? namespaceURI);
79
80     [CEReactions, Custom, MayThrowException] Node insertBefore(Node node, Node? child);
81     [CEReactions, Custom, MayThrowException] Node appendChild(Node node);
82     [CEReactions, Custom, MayThrowException] Node replaceChild(Node node, Node child);
83     [CEReactions, Custom, MayThrowException] Node removeChild(Node child);
84 };
85
86 dictionary GetRootNodeOptions {
87     boolean composed = false;
88 };