src/third_party/WebKit/Source/core/dom/Node.idl

   1 /*
   2  * Copyright (C) 2006, 2007, 2008, 2009 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     DependentLifetime,
  23 ] interface Node : EventTarget {
  24     // NodeType
  25     const unsigned short      ELEMENT_NODE                   = 1;
  26     const unsigned short      ATTRIBUTE_NODE                 = 2;
  27     const unsigned short      TEXT_NODE                      = 3;
  28     const unsigned short      CDATA_SECTION_NODE             = 4;
  29     const unsigned short      ENTITY_REFERENCE_NODE          = 5; // EntityReference nodes are impossible to create in WebKit.
  30     const unsigned short      ENTITY_NODE                    = 6;
  31     const unsigned short      PROCESSING_INSTRUCTION_NODE    = 7;
  32     const unsigned short      COMMENT_NODE                   = 8;
  33     const unsigned short      DOCUMENT_NODE                  = 9;
  34     const unsigned short      DOCUMENT_TYPE_NODE             = 10;
  35     const unsigned short      DOCUMENT_FRAGMENT_NODE         = 11;
  36     const unsigned short      NOTATION_NODE                  = 12;
  37
  38     readonly attribute DOMString nodeName;
  39
  40     [CustomElementCallbacks] attribute DOMString? nodeValue;
  41
  42     readonly attribute unsigned short   nodeType;
  43     [PerWorldBindings] readonly attribute Node             parentNode;
  44     [PerWorldBindings] readonly attribute NodeList         childNodes;
  45     [PerWorldBindings] readonly attribute Node             firstChild;
  46     [PerWorldBindings] readonly attribute Node             lastChild;
  47     [PerWorldBindings] readonly attribute Node             previousSibling;
  48     [PerWorldBindings] readonly attribute Node             nextSibling;
  49     [PerWorldBindings] readonly attribute Document         ownerDocument;
  50
  51     [CustomElementCallbacks, PerWorldBindings, RaisesException, TypeChecking=Interface] Node insertBefore(Node newChild, Node? refChild);
  52     [CustomElementCallbacks, PerWorldBindings, RaisesException, TypeChecking=Interface] Node replaceChild(Node newChild, Node oldChild);
  53     [CustomElementCallbacks, RaisesException, TypeChecking=Interface] Node removeChild(Node oldChild);
  54     [CustomElementCallbacks, PerWorldBindings, RaisesException, TypeChecking=Interface] Node appendChild(Node newChild);
  55
  56     [ImplementedAs=hasChildren] boolean hasChildNodes();
  57     [CustomElementCallbacks] Node cloneNode(optional boolean deep);
  58     [CustomElementCallbacks] void normalize();
  59
  60     // Introduced in DOM Level 2:
  61     [MeasureAs=NodeNamespaceURI] readonly attribute DOMString? namespaceURI; // Moved to Element and Attr in DOM4.
  62     [MeasureAs=NodeLocalName] readonly attribute DOMString? localName; // Moved to Element and Attr in DOM4.
  63
  64     // Introduced in DOM Level 3:
  65     readonly attribute DOMString? baseURI;
  66
  67     [TreatReturnedNullStringAs=Null, TreatNullAs=NullString, TreatUndefinedAs=NullString, CustomElementCallbacks] attribute DOMString textContent;
  68
  69     [MeasureAs=NodeIsSameNode] boolean isSameNode([Default=Undefined] optional Node other); // Removed in DOM4.
  70     boolean isEqualNode(Node other);
  71     DOMString? lookupPrefix(DOMString? namespaceURI);
  72     boolean isDefaultNamespace(DOMString? namespaceURI);
  73     DOMString? lookupNamespaceURI(DOMString? prefix);
  74
  75     // DocumentPosition
  76     const unsigned short      DOCUMENT_POSITION_DISCONNECTED = 0x01;
  77     const unsigned short      DOCUMENT_POSITION_PRECEDING    = 0x02;
  78     const unsigned short      DOCUMENT_POSITION_FOLLOWING    = 0x04;
  79     const unsigned short      DOCUMENT_POSITION_CONTAINS     = 0x08;
  80     const unsigned short      DOCUMENT_POSITION_CONTAINED_BY = 0x10;
  81     const unsigned short      DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;
  82
  83     unsigned short compareDocumentPosition(Node other);
  84
  85     // Introduced in DOM4
  86     boolean contains(Node other);
  87
  88     // IE extensions
  89     [PerWorldBindings] readonly attribute Element parentElement;
  90 };