org.w3c.dom
인터페이스 Node

알려진 서브 인터페이스 목록 :

Attr, CDATASection, CharacterData, Comment, Document, DocumentFragment, DocumentType, Element, Entity, EntityReference, Notation, ProcessingInstruction, Text

알려진 구현 클래스 목록:

IIOMetadataNode

public interface Node

Node인터페이스는 문서 객체 모델 전체에 대한 주데이터형이며, 문서 트리내의 단일의 노드를 나타냅니다. Node인터페이스를 구현하는 모든 객체는 자식을 처리하기 위한 메서드를 가지고 있습니다만, Node인터페이스를 구현하는 모든 객체가 자식을 가질 수 있는 것은 아닙니다. 예를 들어, Text 노드는 자식을 가져 안되어, 이러한 노드에 자식을 추가했을 경우, DOMException가 발생합니다.

nodeName 속성, nodeValue 속성 및 attributes 속성은 특정의 파생 인터페이스에 사로 잡히지 않고 노드 정보를 얻는 메카니즘입니다. Element에 대해서 nodeValue, Comment에 대해서 attributes와 같이, 이러한 속성이 특정의 nodeType에 명확하게 매핑되어 있지 않은 경우는 null을 리턴합니다. 각종 전용 인터페이스는 이외에도, 관련 정보를 취득 및 설정하는 편리한 메카니즘을 다수 갖추고 있습니다.

nodeName, nodeValue 및 attributes값은 다음과 같이 노드형에 따라서 다릅니다.

인터페이스	nodeName	nodeValue	attributes
Attr	Attr.name와 같은	Attr.value와 같은	null
CDATASection	"#cdata-section"	CharacterData.data (CDATA 섹션의 내용)와 같은	null
Comment	"#comment"	CharacterData.data (코멘트의 내용)와 같은	null
Document	"#document"	null	null
DocumentFragment	"#document-fragment"	null	null
DocumentType	DocumentType.name와 같은	null	null
Element	Element.tagName와 같은	null	NamedNodeMap
Entity	실체명	null	null
EntityReference	참조되는 실체의 이름	null	null
Notation	표기 법명	null	null
ProcessingInstruction	ProcessingInstruction.target와 같은	ProcessingInstruction.data와 같은	null
Text	"#text"	CharacterData.data (텍스트 노드의 내용)와 같은	null

「Document Object Model (DOM) Level 3 Core Specification」도 참조하십시오.

필드 개요

static short	ATTRIBUTE_NODE 노드는 Attr 입니다.
static short	CDATA_SECTION_NODE 노드는 CDATASection 입니다.
static short	COMMENT_NODE 노드는 Comment 입니다.
static short	DOCUMENT_FRAGMENT_NODE 노드는 DocumentFragment 입니다.
static short	DOCUMENT_NODE 노드는 Document 입니다.
static short	DOCUMENT_POSITION_CONTAINED_BY 노드는 참조 노드에 포함되어 있습니다.
static short	DOCUMENT_POSITION_CONTAINS 노드는 참조 노드를 포함합니다.
static short	DOCUMENT_POSITION_DISCONNECTED 2개의 노드는 절단 됩니다.
static short	DOCUMENT_POSITION_FOLLOWING 노드는 참조 노드의 후에 계속됩니다.
static short	DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC 선행할까 후에 올까는 구현에 고유합니다.
static short	DOCUMENT_POSITION_PRECEDING 2번째의 노드는 참조 노드의 전에 있습니다.
static short	DOCUMENT_TYPE_NODE 노드는 DocumentType 입니다.
static short	ELEMENT_NODE 노드는 Element 입니다.
static short	ENTITY_NODE 노드는 Entity 입니다.
static short	ENTITY_REFERENCE_NODE 노드는 EntityReference 입니다.
static short	NOTATION_NODE 노드는 Notation 입니다.
static short	PROCESSING_INSTRUCTION_NODE 노드는 ProcessingInstruction 입니다.
static short	TEXT_NODE 노드는 Text 노드입니다.

메서드 개요

Node	appendChild (Node newChild) 노드 newChild를 이 노드의자식 리스트의 말미에 추가합니다.
Node	cloneNode (boolean deep) 노드의 범용 copy constructor로서 이 노드의 복제를 리턴합니다.
short	compareDocumentPosition (Node other) 이 메서드가 불려가 고 있는 참조 노드를, 파라미터로서 건네받는 노드와 문서내의 위치에 관해서 문서순서와 비교합니다.
NamedNodeMap	getAttributes () 이 노드가 Element인 경우, 이 노드의 속성을 포함한 NamedNodeMap 입니다.
String	getBaseURI () 이 노드의 절대 베이스 URI, 구현이 절대 URI를 취득할 수 없었던 경우는 null이 됩니다.
NodeList	getChildNodes () 이 노드의 자식을 모두 포함한 NodeList 입니다.
Object	getFeature (String feature, String version) 이 메서드는 지정한 기능과 버전을 가지는 특수한 형식의 API가 지정되었던 대로 구현하는 특수한 형식의 객체를 리턴합니다.
Node	getFirstChild () 이 노드의 최초의자식 노드입니다.
Node	getLastChild () 이 노드의 마지막자식 노드입니다.
String	getLocalName () 이 노드의 수식명의 로컬 부분을 리턴합니다.
String	getNamespaceURI () 이 노드의 이름 공간 URI.
Node	getNextSibling () 이 노드의 직후의 노드입니다.
String	getNodeName () 이 노드의 이름입니다.
short	getNodeType () 객체의 형태를 나타내는 코드입니다.
String	getNodeValue () 이 노드의 값입니다.
Document	getOwnerDocument () 이 노드에 관련된 Document 객체입니다.
Node	getParentNode () 이 노드의 부모노드입니다.
String	getPrefix () 이 노드의 이름 공간 접두사입니다.
Node	getPreviousSibling () 이 노드의 직전의 노드입니다.
String	getTextContent () 이 속성은 지정된 노드와 노드의 자손의 텍스트 컨텐츠를 리턴합니다.
Object	getUserData (String key) 이 노드의 키에 관련된 객체를 취득합니다.
boolean	hasAttributes () 이 노드가 요소인 경우, 속성을 가지고 있을지 어떨지를 리턴합니다.
boolean	hasChildNodes () 이 노드가자식 노드를 가지고 있을지 어떨지를 리턴합니다.
Node	insertBefore (Node newChild, Node refChild) 기존의 refChild 자식 노드의 전에 newChild 노드를 삽입합니다.
boolean	isDefaultNamespace (String namespaceURI) 이 메서드는 지정된 namespaceURI가 디폴트의 이름 공간일지 어떨지를 체크합니다.
boolean	isEqualNode (Node arg) 2개의 노드가 동일한지 어떤지를 테스트합니다.
boolean	isSameNode (Node other) 이 노드가 지정된 노드와 같은 노드일지 어떨지를 리턴합니다.
boolean	isSupported (String feature, String version) DOM 구현이 특정의 기능을 구현하고 있어, 이 노드가 그 기능이 지정되었던 대로 지원 하고 있을지 어떨지를 판정합니다.
String	lookupNamespaceURI (String prefix) 지정한 노드로부터 개시해, 소정의 접두사에 관련된 이름 공간 URI를 검색합니다.
String	lookupPrefix (String namespaceURI) 지정된 노드로부터 개시해, 소정의 이름 공간 URI에 관련된 접두사를 검색합니다.
void	normalize () 이 Node 서브 트리의 최심부까지 존재하는 모든 Text 노드 (속성 노드를 포함한다)를, Text 노드가 구조 (요소, 코멘트, 처리 명령, CDATA 섹션, 실체 참조등)에만 따라 분리되는 「보통 」형식으로 고칩니다.
Node	removeChild (Node oldChild) 아이 리스트로부터 oldChild로 나타나는자식 노드를 삭제해, 이자식 노드를 리턴합니다.
Node	replaceChild (Node newChild, Node oldChild) oldChild 자식 노드를,자식 리스트의 newChild에 옮겨놓아, oldChild 노드를 리턴합니다.
void	setNodeValue (String nodeValue) 이 노드의 값입니다.
void	setPrefix (String prefix) 이 노드의 이름 공간 접두사입니다.
void	setTextContent (String textContent) 이 속성은 지정된 노드와 노드의 자손의 텍스트 컨텐츠를 리턴합니다.
Object	setUserData (String key, Object data, UserDataHandler handler) 이 노드의 키에 객체를 관련짓습니다.

필드의 상세

ELEMENT_NODE

static final short ELEMENT_NODE

노드는 Element 입니다.

관련 항목:

정수 필드값

ATTRIBUTE_NODE

static final short ATTRIBUTE_NODE

노드는 Attr 입니다.

관련 항목:

정수 필드값

TEXT_NODE

static final short TEXT_NODE

노드는 Text 노드입니다.

관련 항목:

정수 필드값

CDATA_SECTION_NODE

static final short CDATA_SECTION_NODE

노드는 CDATASection 입니다.

관련 항목:

정수 필드값

ENTITY_REFERENCE_NODE

static final short ENTITY_REFERENCE_NODE

노드는 EntityReference 입니다.

관련 항목:

정수 필드값

ENTITY_NODE

static final short ENTITY_NODE

노드는 Entity 입니다.

관련 항목:

정수 필드값

PROCESSING_INSTRUCTION_NODE

static final short PROCESSING_INSTRUCTION_NODE

노드는 ProcessingInstruction 입니다.

관련 항목:

정수 필드값

COMMENT_NODE

static final short COMMENT_NODE

노드는 Comment 입니다.

관련 항목:

정수 필드값

DOCUMENT_NODE

static final short DOCUMENT_NODE

노드는 Document 입니다.

관련 항목:

정수 필드값

DOCUMENT_TYPE_NODE

static final short DOCUMENT_TYPE_NODE

노드는 DocumentType 입니다.

관련 항목:

정수 필드값

DOCUMENT_FRAGMENT_NODE

static final short DOCUMENT_FRAGMENT_NODE

노드는 DocumentFragment 입니다.

관련 항목:

정수 필드값

NOTATION_NODE

static final short NOTATION_NODE

노드는 Notation 입니다.

관련 항목:

정수 필드값

DOCUMENT_POSITION_DISCONNECTED

static final short DOCUMENT_POSITION_DISCONNECTED

2개의 노드는 절단 됩니다. 절단 된 노드의 순서는 항상 구현에 고유의 순서입니다.

관련 항목:

정수 필드값

DOCUMENT_POSITION_PRECEDING

static final short DOCUMENT_POSITION_PRECEDING

2번째의 노드는 참조 노드의 전에 있습니다.

관련 항목:

정수 필드값

DOCUMENT_POSITION_FOLLOWING

static final short DOCUMENT_POSITION_FOLLOWING

노드는 참조 노드의 후에 계속됩니다.

관련 항목:

정수 필드값

DOCUMENT_POSITION_CONTAINS

static final short DOCUMENT_POSITION_CONTAINS

노드는 참조 노드를 포함합니다. 포함한 노드는 항상 참조 노드에 선행합니다.

관련 항목:

정수 필드값

DOCUMENT_POSITION_CONTAINED_BY

static final short DOCUMENT_POSITION_CONTAINED_BY

노드는 참조 노드에 포함되어 있습니다. 포함되는 노드는 항상 참조 노드의 후에 계속됩니다.

관련 항목:

정수 필드값

DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC

static final short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC

선행할까 후에 올까는 구현에 고유합니다.

관련 항목:

정수 필드값

메서드의 상세

getNodeName

String  getNodeName()

이 노드의 이름입니다. 이 이름은 형태에 따라서 다릅니다. 전술의 겉(표)를 참조하십시오.

getNodeValue

String  getNodeValue()
                    throws DOMException 

이 노드의 값입니다. 이 값은 형태에 따라서 다릅니다. 전술의 겉(표)를 참조하십시오. null이 되도록 정의했을 경우는 노드가 읽기 전용 일지 어떨지를 포함해, 이 null을 설정해도 영향은 없습니다.

예외:

DOMException - DOMSTRING_SIZE_ERR: 리턴된 문자수가 너무 많아서 구현 플랫폼상의 DOMString 변수에 들어가지 않는 경우

setNodeValue

void setNodeValue(String  nodeValue)
                  throws DOMException 

이 노드의 값입니다. 이 값은 형태에 따라서 다릅니다. 전술의 겉(표)를 참조하십시오. null이 되도록 정의했을 경우는 노드가 읽기 전용 일지 어떨지를 포함해, 이 null을 설정해도 영향은 없습니다.

예외:

DOMException - NO_MODIFICATION_ALLOWED_ERR: 노드가 읽기 전용 의 경우 및 null 이다고 정의되어 있지 않은 경우

getNodeType

short getNodeType()

객체의 형태를 나타내는 코드입니다. 전술의 정의를 참조하십시오.

getParentNode

Node  getParentNode()

이 노드의 부모노드입니다. Attr, Document, DocumentFragment, Entity, Notation을 제외하는 모든 노드는 부모노드를 가질 가능성이 있습니다. 다만, 노드가 작성되었던 바로 직후로 아직 트리에 추가되어 있지 않은 경우나 트리로부터 삭제되었을 경우는 null이 리턴됩니다 .

getChildNodes

NodeList  getChildNodes()

이 노드의 자식을 모두 포함한 NodeList 입니다. 자식이 존재하지 않는 경우, 노드를 가지지 않는 NodeList이 리턴됩니다 .

getFirstChild

Node  getFirstChild()

이 노드의 최초의자식 노드입니다. 해당하는 노드가 존재하지 않는 경우는 null이 리턴됩니다 .

getLastChild

Node  getLastChild()

이 노드의 마지막자식 노드입니다. 해당하는 노드가 존재하지 않는 경우는 null이 리턴됩니다 .

getPreviousSibling

Node  getPreviousSibling()

이 노드의 직전의 노드입니다. 해당하는 노드가 존재하지 않는 경우는 null이 리턴됩니다 .

getNextSibling

Node  getNextSibling()

이 노드의 직후의 노드입니다. 해당하는 노드가 존재하지 않는 경우는 null이 리턴됩니다 .

getAttributes

NamedNodeMap  getAttributes()

이 노드가 Element인 경우, 이 노드의 속성을 포함한 NamedNodeMap 입니다. 그 외의 경우는 null 입니다.

getOwnerDocument

Document  getOwnerDocument()

이 노드에 관련된 Document 객체입니다. 이것은 새로운 노드를 작성하는 Document 객체이기도 합니다. 이 노드가 아직 어느 Document에 서도 사용되어 있지 않은 Document 또는 DocumentType인 경우, null이 됩니다.

insertBefore

Node  insertBefore(Node  newChild,
                  Node  refChild)
                  throws DOMException 

기존의 refChild 자식 노드의 전에 newChild 노드를 삽입합니다. refChild가 null인 경우,자식 리스트의 마지막에 newChild를 삽입합니다.
newChild가 DocumentFragment 객체인 경우는 객체의 모든 자식이 같은 순서로 refChild 전에 삽입됩니다. newChild는 이미 트리안에 있는 경우, 최초로 삭제됩니다.

주: 노드를 노드 자체의 전에 삽입하는 경우는 구현에 의존합니다.

파라미터:

newChild - 삽입되는 노드

refChild - 참조 노드. 새로운 노드는 이 노드의 직전에 삽입된다

반환값:

삽입된 노드

예외:

DOMException - HIERARCHY_REQUEST_ERR: 이 노드가 newChild 노드형의 자식을 허가하지 않는 형태의 노드인 경우, 삽입하는 노드가 이 노드의 선조의 1개 또는 이 노드 자체인 경우, 혹은 이 노드가 Document 형의 노드이며, 한편 DOM 어플리케이션이 제 2 DocumentType 또는 Element 노드를 삽입하려고 했을 경우
WRONG_DOCUMENT_ERR: newChild가 이 노드를 작성한 문서와는 다른 문서로부터 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽기 전용 의 경우, 또는 삽입하고 있는 노드의 부모가 읽기 전용 의 경우
NOT_FOUND_ERR: refChild가 이 노드의 자식이 아닌 경우
NOT_SUPPORTED_ERR: 이 노드가 Document 형의 노드인 경우. 또, DOM 구현이 DocumentType 또는 Element 노드의 삽입을 지원 하고 있지 않는 경우에도 이 예외가 Throw 될 가능성이 있다

replaceChild

Node  replaceChild(Node  newChild,
                  Node  oldChild)
                  throws DOMException 

oldChild 자식 노드를,자식 리스트의 newChild에 옮겨놓아, oldChild 노드를 리턴합니다.
newChild가 DocumentFragment 객체인 경우, oldChild는 DocumentFragment 모든자식 로 옮겨집니다. 모든자식는 같은 순서로 삽입됩니다. newChild는 트리안에 이미 있는 경우, 최초로 삭제됩니다.

주: 노드를 노드 자체에 옮겨놓는 경우는 구현에 의존합니다.

파라미터:

newChild - 자 리스트에 삽입하는 새로운 노드

oldChild - 치환의 대상이 되는 리스트내의 노드

반환값:

옮겨놓을 수 있었던 노드

예외:

DOMException - HIERARCHY_REQUEST_ERR: 이 노드가 newChild 노드형의 자식을 허가하지 않는 형태의 노드인 경우, 또는 삽입하는 노드가 이 노드의 선조의 1개 또는 이 노드 자체인 경우, 혹은 이 노드가 Document 형의 노드이며, 옮겨놓은 결과, Document에 제 2 DocumentType 또는 Element 노드를 추가하려고 했을 경우
WRONG_DOCUMENT_ERR: newChild가 이 노드를 작성한 문서와는 다른 문서로부터 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드 또는 새로운 노드의 부모가 읽기 전용 의 경우
NOT_FOUND_ERR: oldChild가 이 노드의 자식이 아닌 경우
NOT_SUPPORTED_ERR: 이 노드가 Document 형의 노드인 경우. 또, DOM 구현이 DocumentType 자식 또는 Element 자식 의 치환을 지원 하고 있지 않는 경우에도 이 예외가 Throw 될 가능성이 있다

removeChild

Node  removeChild(Node  oldChild)
                 throws DOMException 

아이 리스트로부터 oldChild로 나타나는자식 노드를 삭제해, 이자식 노드를 리턴합니다.

파라미터:

oldChild - 삭제되는 노드

반환값:

삭제된 노드

예외:

DOMException - NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽기 전용 의 경우
NOT_FOUND_ERR: oldChild가 이 노드의 자식이 아닌 경우
NOT_SUPPORTED_ERR: 이 노드가 Document 형인 경우. 또, DOM 구현이DocumentType 자식 또는 Element 자식 의 삭제를 지원 하고 있지 않는 경우, 이 예외가 Throw 될 가능성이 있다

appendChild

Node  appendChild(Node  newChild)
                 throws DOMException 

노드 newChild를 이 노드의자식 리스트의 말미에 추가합니다. newChild가 트리내에 이미 존재하는 경우, 최초로 기존의 것이 삭제됩니다.

파라미터:

newChild - 추가하는 노드. 추가하는 노드가 DocumentFragment 객체인 경우, 문서 fragment의 전컨텐츠가 이 노드의자식 리스트로 이동한다

반환값:

추가된 노드

예외:

DOMException - HIERARCHY_REQUEST_ERR: 이 노드가 newChild 노드형의 자식을 허가하지 않는 형태의 노드인 경우, 또는 변환하는 노드가 이 노드의 선조의 1개 또는 이 노드 자체인 경우, 혹은 이 노드가 Document 형의 노드이며, 한편 DOM 어플리케이션이 제 2 DocumentType 또는 Element 노드를 추가하려고 했을 경우
WRONG_DOCUMENT_ERR: newChild가 이 노드를 작성한 문서와는 다른 문서로부터 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽기 전용 의 경우 또는 삽입하고 있는 노드의 전의 부모가 읽기 전용 의 경우
NOT_SUPPORTED_ERR: newChild 노드가 Document 노드의자식 인 경우. 또, DOM 구현이 DocumentType 자식 또는 Element 자식 의 삭제를 지원 하고 있지 않는 경우에도 이 예외가 Throw 될 가능성이 있다

hasChildNodes

boolean hasChildNodes()

이 노드가자식 노드를 가지고 있을지 어떨지를 리턴합니다.

반환값:

이 노드가 자식을 가지고 있는 경우는 true, 그렇지 않은 경우는 false

cloneNode

Node  cloneNode(boolean deep)

노드의 범용 copy constructor로서 이 노드의 복제를 리턴합니다. 복제 노드는 부모노드를 가지지 않고 (parentNode가 null), 사용자 데이터를 가지지 않습니다. 임포트 되고 있는 노드에 관련된 사용자 데이터는 미루어지지 않습니다. 다만, 관련된 데이터와 함께 UserDataHandlers가 지정되었을 경우, 핸들러는 이 메서드가 돌려주기 전에 해당하는 파라미터와 함께 호출합니다.
Element를 복제하면, 그 속성 전부 및 그러한 속성값 (XML 프로세서에 의해 생성된 것을 포함한다)가 카피되어 디폴트의 속성이 됩니다. 다만, 이 메서드는 Element에 포함되는자식는 깊은 복제를 실시하지 않는 한 카피되지 않습니다.자식 Text 노드에는 텍스트가 포함되므로 이 텍스트에는 Element에 포함되는 텍스트도 포함됩니다. Element 복제의 일환으로서가 아니고, Attr를 직접 복제하면, 지정된 속성이 리턴됩니다 (specified는 true). Attr를 복제하면, 자식이 Attr 값을 나타내므로 복제의 심도에 관계없이, Attr 자식이 항상 복제됩니다. EntityReference를 복제하면, 복제의 심도에 관계없이, 대응하는 Entity가 존재하는 경우는 자동적으로 EntityReference 서브 트리가 작성됩니다. 다른 형태의 노드를 복제하면, 이 노드의 카피가 리턴됩니다 .
불변의 서브 트리를 복제하면 가변의 카피가 작성됩니다만, EntityReference 복제의자식는 읽기 전용이 됩니다. 또, 미지정의 Attr 노드의 복제가 지정됩니다. Document, DocumentType, Entity, Notation 각 노드의 복제는 구현에 의해 다릅니다.

파라미터:

deep - true인 경우, 지정된 노드의 서브 트리를 재귀적으로 복제. false인 경우, 지정된 노드만을 복제. 지정된 노드가 Element인 경우는 그 속성도 복제

반환값:

복제 노드

normalize

void normalize()

이 Node 서브 트리의 최심부까지 존재하는 모든 Text 노드 (속성 노드를 포함한다)를, Text 노드가 구조 (요소, 코멘트, 처리 명령, CDATA 섹션, 실체 참조등)에만 따라 분리되는 「보통 」형식으로 고칩니다. 그 결과, 인접하는Text 노드도 비어있는 Text 노드도 존재하지 않는 상태가 됩니다. 이 조작은 문서의 DOM 뷰를 보존 후 다시 로드한 상태로 할 수 있다고 하는 점으로써, 특정의 문서 트리 구조에 의존된 조작 (XPointer「XPointer」룩 업등)을 실시할 필요가 있는 경우에 편리합니다. Node.ownerDocument에 추가된 DOMConfiguration 객체의 normalize-characters 파라미터가 true인 경우, 이 메서드는 Text 노드의 문자의 완전한 정규화도 실시합니다.

주: 문서가 CDATASections를 포함한 경우, 정규화 조작만으로는 충분하지 않을 가능성이 있습니다. 이것은 XPointer가 Text 노드와 CDATASection 노드를 구별하지 않기 때문입니다.

isSupported

boolean isSupported(String  feature,
                    String  version)

DOM 구현이 특정의 기능을 구현하고 있어, 이 노드가 그 기능이 지정되었던 대로 지원 하고 있을지 어떨지를 판정합니다.

파라미터:

feature - 테스트하는 기능의 이름

version - 테스트하는 기능의 버전 번호

반환값:

지정된 기능이 이 노드로 지원 되고 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

DOM Level 2

getNamespaceURI

String  getNamespaceURI()

이 노드의 이름 공간 URI. 지정되어 있지 않은 경우는 null (참조)
이 값은 스코프내의 이름 공간 선언의 검사에 근거한 이름 공간 검색의 결과로서 계산된 값은 아니고, 작성시로 지정된 이름 공간 URI 입니다.
ELEMENT_NODE 및 ATTRIBUTE_NODE 이외의 형태의 노드나, Document.createElement() 라고 하는 DOM Level 1 메서드로 작성된 노드의 경우는 항상 null 입니다.

주: XML 사양의 XML 이름 공간의 규정에의하면 속성은 그 접속처 요소로부터 이름 공간을 상속하지 않습니다. 속성에 대해서 명시적으로 이름 공간을 지정하지 않는 한, 그 속성은 이름 공간을 가지지 않게 됩니다.

도입된 버전 :

DOM Level 2

getPrefix

String  getPrefix()

이 노드의 이름 공간 접두사입니다. 미지정의 경우는 null 입니다. null 라고 정의되고 있는 경우, 노드가 읽기 전용 인 경우를 포함해, 설정은 아무것도 영향을 주지 않습니다.
이 속성을 설정하면, 가능한 경우, 수식명을 보관 유지하는 nodeName 속성, Element tagName 속성과 name 속성 및 Attr인터페이스가 변경됩니다.
접두사를 null로 설정하면, 접두사는 지정되지 않습니다. 또, 비어있는 캐릭터 라인으로 설정하는 것은 구현 존입니다.
기정의 값을 가지는 것을 알 수 있는 속성의 접두사를 변경하면, 규정의 값을 가지는 새로운 속성은 작성되지 않고, 원의 접두사가 표시되게도 주의가 필요합니다. 이것은, namespaceURI와 localName가 변함없기 때문입니다.
ELEMENT_NODE와 ATTRIBUTE_NODE 이외의 형태의 노드 및 Document인터페이스로부터의 createElement 라고 하는 DOM Level 1 메서드로 작성된 노드의 경우, 이것은 항상 null 입니다.

도입된 버전 :

DOM Level 2

setPrefix

void setPrefix(String  prefix)
               throws DOMException 

이 노드의 이름 공간 접두사입니다. 미지정의 경우는 null 입니다. null 라고 정의되고 있는 경우, 노드가 읽기 전용 인 경우를 포함해, 설정은 아무것도 영향을 주지 않습니다.
이 속성을 설정하면, 가능한 경우, 수식명을 보관 유지하는 nodeName 속성, Element tagName 속성과 name 속성 및 Attr인터페이스가 변경됩니다.
접두사를 null로 설정하면, 접두사는 지정되지 않습니다. 또, 비어있는 캐릭터 라인으로 설정하는 것은 구현 존입니다.
기정의 값을 가지는 것을 알 수 있는 속성의 접두사를 변경하면, 규정의 값을 가지는 새로운 속성은 작성되지 않고, 원의 접두사가 표시되게도 주의가 필요합니다. 이것은, namespaceURI와 localName가 변함없기 때문입니다.
ELEMENT_NODE와 ATTRIBUTE_NODE 이외의 형태의 노드 및 Document인터페이스로부터의 createElement 라고 하는 DOM Level 1 메서드로 작성된 노드의 경우, 이것은 항상 null 입니다.

예외:

DOMException - INVALID_CHARACTER_ERR: 지정된 접두사에 사용중의 XML 버전 (Document.xmlVersion 속성으로 지정)으로 정해져 있는 부정한 문자가 포함되어 있는 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽기 전용 의 경우
NAMESPACE_ERR: 지정된 prefix가 XML 사양의 이름 공간의 정의에 따른 것 나오지 않는 경우, 이 노드의 namespaceURI가 null인 경우, 지정된 접두사가 「xml」이며, 한편 이 노드의 namespaceURI가 「http://www.w3.org/XML/1998/namespace」란 다른 경우, 이 노드가 속성이며, 지정된 접두사가 「xmlns」이며, 이 노드의 namespaceURI가 「http://www.w3.org/2000/xmlns/」(이)란 다른 경우, 또는 이 노드가 속성이며, 이 노드의 qualifiedName가 「xmlns」의 XML 이름 공간인 경우

도입된 버전 :

DOM Level 2

getLocalName

String  getLocalName()

이 노드의 수식명의 로컬 부분을 리턴합니다.
ELEMENT_NODE와 ATTRIBUTE_NODE 이외의 형태의 노드와Document.createElement() 등의 DOM 레벨 1 메서드로 작성된 노드에 대해서는 항상 null이 리턴됩니다 .

도입된 버전 :

DOM Level 2

hasAttributes

boolean hasAttributes()

이 노드가 요소인 경우, 속성을 가지고 있을지 어떨지를 리턴합니다.

반환값:

이 노드가 속성을 가지고 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

DOM Level 2

getBaseURI

String  getBaseURI()

이 노드의 절대 베이스 URI, 구현이 절대 URI를 취득할 수 없었던 경우는 null이 됩니다. 이 값은 설명에 따라 계산됩니다. 다만, Document이 「HTML」기능「DOM Level 2 HTML」를 지원하는인 경우, 베이스 URI는 우선 HTML BASE 요소의 href 속성의 값 (존재하는 경우)을 사용해 계산되어 그렇지 않은 경우는 Document인터페이스의 documentURI 속성의 값을 사용해 계산됩니다.

도입된 버전 :

DOM Level 3

compareDocumentPosition

short compareDocumentPosition(Node  other)
                              throws DOMException 

이 메서드가 불려가 고 있는 참조 노드를, 파라미터로서 건네받는 노드와 문서내의 위치에 관해서 문서순서와 비교합니다.

파라미터:

other - 참조 노드와 비교하는 노드

반환값:

참조 노드에 대해서 노드의 상대적인 위치를 결정하는 방법

예외:

DOMException - NOT_SUPPORTED_ERR: 비교 대상 노드가 일관한 구현 고유의 결과를 돌려주도록 조정하지 않는 다른 DOM 구현의 노드인 경우

도입된 버전 :

DOM Level 3

getTextContent

String  getTextContent()
                      throws DOMException 

이 속성은 지정된 노드와 노드의 자손의 텍스트 컨텐츠를 리턴합니다. 이 속성을 null에 정의했을 경우, 설정에 한 영향은 없습니다. 설정에서는 이 노드가 가질 수 있는 생각되는자식는 모두 삭제되어 새로운 캐릭터 라인이 공백 또는 null인 경우, 이 속성이 설정되어 있는 캐릭터 라인을 포함한 단일의 Text 노드로 옮겨집니다.
취득에서는 직렬화는 행해지지 않고, 리턴된 캐릭터 라인은 마크 업을 포함하지 않습니다. 공백 문자의 정규화는 행해지지 않고, 리턴된 캐릭터 라인은 요소 컨텐츠에 공백 문자를 포함하지 않습니다 (Text.isElementContentWhitespace 속성을 참조). 같이 설정에서는 해석도 행해지지 않습니다. 입력 캐릭터 라인은 순수한 텍스트 형식의 컨텐츠로서 취득됩니다.
리턴된 캐릭터 라인은 다음에 나타내도록 노드의 형태에 응해, 노드의 텍스트 컨텐츠로 구성되어 있습니다.

노드형	컨텐츠
ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, DOCUMENT_FRAGMENT_NODE	COMMENT_NODE 노드와 PROCESSING_INSTRUCTION_NODE 노드를 제외한, 모든자식 노드의 textContent 속성값의 연결. 노드가 자식을 가지지 않는 경우는 비어있는 캐릭터 라인
TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE	nodeValue
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE	null

예외:

DOMException - DOMSTRING_SIZE_ERR: 리턴된 문자수가 너무 많아서 구현 플랫폼상의 DOMString 변수에 들어가지 않는 경우

도입된 버전 :

DOM Level 3

setTextContent

void setTextContent(String  textContent)
                    throws DOMException 

이 속성은 지정된 노드와 노드의 자손의 텍스트 컨텐츠를 리턴합니다. 이 속성을 null에 정의했을 경우, 설정에 한 영향은 없습니다. 설정에서는 이 노드가 가질 수 있는 생각되는자식는 모두 삭제되어 새로운 캐릭터 라인이 공백 또는 null인 경우, 이 속성이 설정되어 있는 캐릭터 라인을 포함한 단일의 Text 노드로 옮겨집니다.
취득에서는 직렬화는 행해지지 않고, 리턴된 캐릭터 라인은 마크 업을 포함하지 않습니다. 공백 문자의 정규화는 행해지지 않고, 리턴된 캐릭터 라인은 요소 컨텐츠에 공백 문자를 포함하지 않습니다 (Text.isElementContentWhitespace 속성을 참조). 같이 설정에서는 해석도 행해지지 않습니다. 입력 캐릭터 라인은 순수한 텍스트 형식의 컨텐츠로서 취득됩니다.
리턴된 캐릭터 라인은 다음에 나타내도록 노드의 형태에 응해, 노드의 텍스트 컨텐츠로 구성되어 있습니다.

노드형	컨텐츠
ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, DOCUMENT_FRAGMENT_NODE	COMMENT_NODE 노드와 PROCESSING_INSTRUCTION_NODE 노드를 제외한, 모든자식 노드의 textContent 속성값의 연결. 노드가 자식을 가지지 않는 경우는 비어있는 캐릭터 라인
TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE	nodeValue
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE	null

예외:

DOMException - NO_MODIFICATION_ALLOWED_ERR: 노드가 읽기 전용 의 경우

도입된 버전 :

DOM Level 3

isSameNode

boolean isSameNode(Node  other)

이 노드가 지정된 노드와 같은 노드일지 어떨지를 리턴합니다.
이 메서드를 사용하면, 구현으로 리턴된 2개의 Node 참조가 같은 객체를 참조할지 어떨지를 판정할 수 있습니다. 2개의 Node 참조가 같은 객체를 참조하는 경우는 프록시를 통한 참조의 경우에서도, 모든 속성이 같은 값을 가져, 어느 쪽인가의 참조의 같은 DOM 메서드의 호출이 항상 완전히 같은 효과를 발휘하도록, 참조를 완전하게 교대로 사용할 수 있습니다.

파라미터:

other - 테스트 대상의 노드

반환값:

노드가 같은 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

DOM Level 3

lookupPrefix

String  lookupPrefix(String  namespaceURI)

지정된 노드로부터 개시해, 소정의 이름 공간 URI에 관련된 접두사를 검색합니다. 이 메서드는 디폴트의 이름 공간 선언을 무시합니다.
자세한 것은 이 메서드로 사용되는 알고리즘을 참조하십시오.

파라미터:

namespaceURI - 검색하는 이름 공간 URI

반환값:

발견되었을 경우는 관련된 이름 공간 접두사, 발견되지 않았던 경우는 null. 복수의 접두사가 이름 공간 접두사에 관련된 경우, 리턴된 이름 공간 접두사는 구현에 응해 다른

도입된 버전 :

DOM Level 3

isDefaultNamespace

boolean isDefaultNamespace(String  namespaceURI)

이 메서드는 지정된 namespaceURI가 디폴트의 이름 공간일지 어떨지를 체크합니다.

파라미터:

namespaceURI - 검색하는 이름 공간 URI

반환값:

지정된 namespaceURI가 디폴트의 이름 공간인 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

DOM Level 3

lookupNamespaceURI

String  lookupNamespaceURI(String  prefix)

지정한 노드로부터 개시해, 소정의 접두사에 관련된 이름 공간 URI를 검색합니다.
자세한 것은 이 메서드로 사용되는 알고리즘을 참조하십시오.

파라미터:

prefix - 검색하는 접두사. 이 파라미터가 null인 경우, 메서드는 디폴트의 이름 공간 URI를 돌려준다 (존재하는 경우)

반환값:

관련된 이름 공간 URI, 발견되지 않았던 경우는 null

도입된 버전 :

DOM Level 3

isEqualNode

boolean isEqualNode(Node  arg)

2개의 노드가 동일한지 어떤지를 테스트합니다.
이 메서드는 Node.isSameNode()를 사용해 테스트할 수 있는 노드의 동일성 (2개의 노드가 같은 객체를 참조할지 어떨지)은 아니고 동등성을 테스트합니다. 같다 모든 노드는 동등하기도 합니다만, 그 역은 반드시 들어맞지 않습니다.　
2개의 노드가 동등해요는 다음의 조건이 채워지는 경우만입니다.

• 2개의 노드가 같은 형태의 노드이다
• 캐릭터 라인 속성의 nodeName, localName, namespaceURI, prefix, nodeValue가 동일하다. 즉, 2개의 노드가 null인지, 같은 길이를 가져, 동일 문자의 문자이다
• attributes NamedNodeMaps가 동일하다. 즉, 2개의 노드가 양쪽 모두 null인지, 또는 같은 길이를 가져, 1개의 맵에 존재하는 각 노드에 대해서 다른 맵에 존재하는 노드가 있어, 동일하지만, 반드시 같은 인덱스에는 없다
• childNodes NodeLists가 동일하다. 즉, 양쪽 모두 null인지, 또는 같은 길이를 가져, 같은 인덱스에 동일한 노드를 가진다. 정규화는 동등성에 영향을 미칠 가능성이 있는 것에 주의가 필요. 이 영향을 피하려면, 노드를 정규화하고 나서 비교를 실시할 필요가 있다

2개의 DocumentType 노드가 동일하기 위해는 다음의 조건이 채워질 필요가 있습니다.

• 캐릭터 라인 속성의 publicId, systemId, internalSubset이 동일하다
• entities NamedNodeMaps가 동일하다
• notations NamedNodeMaps가 동일하다

한편, 다음은 동등성에 영향을 주지 않습니다. ownerDocument, baseURI 및 parentNode 속성, Attr 노드의 specified 속성, Attr 노드와 Element 노드의 schemaTypeInfo 속성, Text 노드의 Text.isElementContentWhitespace 속성 및 노드에 등록되어 있는 사용자 데이터 또는 이벤트 리스너

주:일반적으로 위의 설명으로 다루어지지 않은 것은 동일성 체크의 면에서 미가 있지는 않습니다. 이 사양의 장래 버전에 서는 보다 많은 속성을 고려해, 이 사양에 준거하는 구현을 적당 갱신할 예정입니다.

파라미터:

arg - 동일성을 비교하는 대상의 노드

반환값:

노드가 동일한 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

DOM Level 3

getFeature

Object  getFeature(String  feature,
                  String  version)

이 메서드는 지정한 기능과 버전을 가지는 특수한 형식의 API가 지정되었던 대로 구현하는 특수한 형식의 객체를 리턴합니다. 특수한 형식의 객체는 바인딩 고유의 캐스팅 메서드를 사용해 취득할 수도 있습니다만, 반드시 설명되고 있도록 네 오지 않습니다. 이 메서드를 사용하면, 구현에서는 Node인터페이스를 지원 하고 있지 않는 특수한 형식의 객체를 이용할 수 있습니다.

파라미터:

feature - 요구된 기능의 이름. 기능명의 전에 추가되는 플러스 기호 「+」은 이 메서드의 컨텍스트에 서는 의미가 있지 않기 때문에 무시되는

version - 테스트하는 기능의 버전 번호

반환값:

지정된 기능과 버전의 특수한 형식의 API를 구현하는 객체 (존재하는 경우). 지정된 기능에 관련된 인터페이스를 구현하는 객체가 존재하지 않는 경우는 null. 이 메서드에 의해 리턴된 DOMObject이 Node인터페이스를 구현하는 경우, 이 인터페이스를 주요 코어 Node에 위양 해, attributes, childNodes 라고 하는 주요 코어 Node와 정합하지 않는 결과를 돌려주는 것이 없게 할 필요가 있는

도입된 버전 :

DOM Level 3

setUserData

Object  setUserData(String  key,
                   Object  data,
                   UserDataHandler  handler)

이 노드의 키에 객체를 관련짓습니다. 이 이후, 객체는 같은 키로 getUserData를 호출해 취득할 수 있습니다.

파라미터:

key - 객체를 관련짓는 키

data - 소정의 키에 관련짓는 객체. 소정의 키에 대한 기존의 관련을 삭제하려면 null

handler - 소정의 키에 관련짓는 핸들러, 또는 null

반환값:

이 노드의 소정의 키에 이전 관련지을 수 있고 있던 DOMUserData. DOMUserData가 없었던 경우는 null

도입된 버전 :

DOM Level 3

getUserData

Object  getUserData(String  key)

이 노드의 키에 관련된 객체를 취득합니다. 객체는 우선 같은 키로 setUserData를 호출해, 이 노드에 대해서 이미 설정되어 있을 필요가 있습니다.

파라미터:

key - 객체를 관련된 키

반환값:

이 노드의 소정의 키에 관련된 DOMUserData. DOMUserData가 없었던 경우는 null

도입된 버전 :

DOM Level 3