Remove Objective-C specific extended attributes from the bindings
[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     CustomToJSObject,
24     ExportMacro=WEBCORE_EXPORT,
25     JSCustomHeader,
26     JSCustomMarkFunction,
27     JSCustomPushEventHandlerScope,
28 ] interface Node : EventTarget
29  {
30     // NodeType
31     const unsigned short      ELEMENT_NODE                   = 1;
32     const unsigned short      ATTRIBUTE_NODE                 = 2;
33     const unsigned short      TEXT_NODE                      = 3;
34     const unsigned short      CDATA_SECTION_NODE             = 4;
35     const unsigned short      ENTITY_REFERENCE_NODE          = 5;
36     const unsigned short      ENTITY_NODE                    = 6;
37     const unsigned short      PROCESSING_INSTRUCTION_NODE    = 7;
38     const unsigned short      COMMENT_NODE                   = 8;
39     const unsigned short      DOCUMENT_NODE                  = 9;
40     const unsigned short      DOCUMENT_TYPE_NODE             = 10;
41     const unsigned short      DOCUMENT_FRAGMENT_NODE         = 11;
42     const unsigned short      NOTATION_NODE                  = 12;
43
44     readonly attribute DOMString nodeName;
45
46     // FIXME: the spec says this can also raise on retrieval.
47     [SetterRaisesException] attribute DOMString? nodeValue;
48
49     readonly attribute unsigned short   nodeType;
50     readonly attribute Node             parentNode;
51     readonly attribute NodeList         childNodes;
52     readonly attribute Node             firstChild;
53     readonly attribute Node             lastChild;
54     readonly attribute Node             previousSibling;
55     readonly attribute Node             nextSibling;
56     readonly attribute Document         ownerDocument;
57
58     [Custom, RaisesException] Node insertBefore([CustomReturn] Node newChild, Node? refChild);
59     [Custom, RaisesException] Node replaceChild(Node newChild, [CustomReturn] Node oldChild);
60     [Custom, RaisesException, CEReactions] Node removeChild([CustomReturn] Node oldChild);
61     [Custom, RaisesException, CEReactions] Node appendChild([CustomReturn] Node newChild);
62
63     boolean            hasChildNodes();
64
65     [NewObject, RaisesException, ImplementedAs=cloneNodeForBindings, CEReactions] Node cloneNode(optional boolean deep = false);
66
67     void               normalize();
68
69     // Introduced in DOM Level 2:
70
71 #if !defined(LANGUAGE_JAVASCRIPT) || !LANGUAGE_JAVASCRIPT
72     [ImplementedAs=isSupportedForBindings] boolean isSupported(optional DOMString feature, optional DOMString version);
73 #endif
74
75     // Introduced in DOM Level 3:
76
77     readonly attribute USVString baseURI;
78
79     // FIXME: the spec says this can also raise on retrieval.
80     [SetterRaisesException] attribute DOMString? textContent;
81
82     boolean isSameNode(Node? other);
83     boolean isEqualNode(Node? other);
84
85     DOMString? lookupPrefix(DOMString? namespaceURI);
86     DOMString? lookupNamespaceURI(DOMString? prefix);
87     boolean isDefaultNamespace(DOMString? namespaceURI);
88
89     // DocumentPosition
90     const unsigned short      DOCUMENT_POSITION_DISCONNECTED = 0x01;
91     const unsigned short      DOCUMENT_POSITION_PRECEDING    = 0x02;
92     const unsigned short      DOCUMENT_POSITION_FOLLOWING    = 0x04;
93     const unsigned short      DOCUMENT_POSITION_CONTAINS     = 0x08;
94     const unsigned short      DOCUMENT_POSITION_CONTAINED_BY = 0x10;
95     const unsigned short      DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;
96
97     unsigned short compareDocumentPosition(Node other);
98
99     // Introduced in DOM4
100     boolean contains(Node? other);
101
102     [EnabledAtRuntime=ShadowDOM, ImplementedAs=inDocument] readonly attribute boolean isConnected;
103
104     // IE extensions
105     readonly attribute Element          parentElement;
106 };
107