Interface Comment

Textual notations within markup; although it is generally not visually shown, such comments are available to be read in the source view.

MDN Reference

interface Comment {
    ATTRIBUTE_NODE: 2;
    baseURI: string;
    CDATA_SECTION_NODE: 4;
    childNodes: NodeListOf<ChildNode>;
    COMMENT_NODE: 8;
    data: string;
    DOCUMENT_FRAGMENT_NODE: 11;
    DOCUMENT_NODE: 9;
    DOCUMENT_POSITION_CONTAINED_BY: 16;
    DOCUMENT_POSITION_CONTAINS: 8;
    DOCUMENT_POSITION_DISCONNECTED: 1;
    DOCUMENT_POSITION_FOLLOWING: 4;
    DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32;
    DOCUMENT_POSITION_PRECEDING: 2;
    DOCUMENT_TYPE_NODE: 10;
    ELEMENT_NODE: 1;
    ENTITY_NODE: 6;
    ENTITY_REFERENCE_NODE: 5;
    firstChild: ChildNode;
    isConnected: boolean;
    lastChild: ChildNode;
    length: number;
    nextElementSibling: Element;
    nextSibling: ChildNode;
    nodeName: string;
    nodeType: number;
    nodeValue: string;
    NOTATION_NODE: 12;
    ownerDocument: Document;
    parentElement: HTMLElement;
    parentNode: ParentNode;
    previousElementSibling: Element;
    previousSibling: ChildNode;
    PROCESSING_INSTRUCTION_NODE: 7;
    TEXT_NODE: 3;
    textContent: string;
    addEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
    after(...nodes: (string | Node)[]): void;
    appendChild<T>(node: T): T;
    appendData(data: string): void;
    before(...nodes: (string | Node)[]): void;
    cloneNode(deep?: boolean): Node;
    compareDocumentPosition(other: Node): number;
    contains(other: Node): boolean;
    deleteData(offset: number, count: number): void;
    dispatchEvent(event: Event): boolean;
    getRootNode(options?: GetRootNodeOptions): Node;
    hasChildNodes(): boolean;
    insertBefore<T>(node: T, child: Node): T;
    insertData(offset: number, data: string): void;
    isDefaultNamespace(namespace: string): boolean;
    isEqualNode(otherNode: Node): boolean;
    isSameNode(otherNode: Node): boolean;
    lookupNamespaceURI(prefix: string): string;
    lookupPrefix(namespace: string): string;
    normalize(): void;
    remove(): void;
    removeChild<T>(child: T): T;
    removeEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
    replaceChild<T>(node: Node, child: T): T;
    replaceData(offset: number, count: number, data: string): void;
    replaceWith(...nodes: (string | Node)[]): void;
    substringData(offset: number, count: number): string;
}

Hierarchy

CharacterData
- Comment (view full)

Index

Properties

`Readonly`ATTRIBUTE_NODE

ATTRIBUTE_NODE: 2

`Readonly`baseURI

baseURI: string

Returns node's node document's document base URL.

MDN Reference

`Readonly`CDATA_SECTION_NODE

CDATA_SECTION_NODE: 4

node is a CDATASection node.

`Readonly`childNodes

childNodes: NodeListOf<ChildNode>

Returns the children.

MDN Reference

`Readonly`COMMENT_NODE

COMMENT_NODE: 8

node is a Comment node.

data

data: string

MDN Reference

`Readonly`DOCUMENT_FRAGMENT_NODE

DOCUMENT_FRAGMENT_NODE: 11

node is a DocumentFragment node.

`Readonly`DOCUMENT_NODE

DOCUMENT_NODE: 9

node is a document.

`Readonly`DOCUMENT_POSITION_CONTAINED_BY

DOCUMENT_POSITION_CONTAINED_BY: 16

Set when other is a descendant of node.

`Readonly`DOCUMENT_POSITION_CONTAINS

DOCUMENT_POSITION_CONTAINS: 8

Set when other is an ancestor of node.

`Readonly`DOCUMENT_POSITION_DISCONNECTED

DOCUMENT_POSITION_DISCONNECTED: 1

Set when node and other are not in the same tree.

`Readonly`DOCUMENT_POSITION_FOLLOWING

DOCUMENT_POSITION_FOLLOWING: 4

Set when other is following node.

`Readonly`DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC

DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32

`Readonly`DOCUMENT_POSITION_PRECEDING

DOCUMENT_POSITION_PRECEDING: 2

Set when other is preceding node.

`Readonly`DOCUMENT_TYPE_NODE

DOCUMENT_TYPE_NODE: 10

node is a doctype.

`Readonly`ELEMENT_NODE

ELEMENT_NODE: 1

node is an element.

`Readonly`ENTITY_NODE

ENTITY_NODE: 6

`Readonly`ENTITY_REFERENCE_NODE

ENTITY_REFERENCE_NODE: 5

`Readonly`firstChild

firstChild: ChildNode

Returns the first child.

MDN Reference

`Readonly`isConnected

isConnected: boolean

Returns true if node is connected and false otherwise.

MDN Reference

`Readonly`lastChild

lastChild: ChildNode

Returns the last child.

MDN Reference

`Readonly`length

length: number

MDN Reference

`Readonly`nextElementSibling

nextElementSibling: Element

Returns the first following sibling that is an element, and null otherwise.

MDN Reference

`Readonly`nextSibling

nextSibling: ChildNode

Returns the next sibling.

MDN Reference

`Readonly`nodeName

nodeName: string

Returns a string appropriate for the type of node.

MDN Reference

`Readonly`nodeType

nodeType: number

Returns the type of node.

MDN Reference

nodeValue

nodeValue: string

MDN Reference

`Readonly`NOTATION_NODE

NOTATION_NODE: 12

`Readonly`ownerDocument

ownerDocument: Document

Returns the node document. Returns null for documents.

MDN Reference

`Readonly`parentElement

parentElement: HTMLElement

Returns the parent element.

MDN Reference

`Readonly`parentNode

parentNode: ParentNode

Returns the parent.

MDN Reference

`Readonly`previousElementSibling

previousElementSibling: Element

Returns the first preceding sibling that is an element, and null otherwise.

MDN Reference

`Readonly`previousSibling

previousSibling: ChildNode

Returns the previous sibling.

MDN Reference

`Readonly`PROCESSING_INSTRUCTION_NODE

PROCESSING_INSTRUCTION_NODE: 7

node is a ProcessingInstruction node.

`Readonly`TEXT_NODE

TEXT_NODE: 3

node is a Text node.

textContent

textContent: string

MDN Reference

Methods

addEventListener

addEventListener(type, callback, options?): void
Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched.

The options argument sets listener-specific options. For compatibility this can be a boolean, in which case the method behaves exactly as if the value was specified as options's capture.

When set to true, options's capture prevents callback from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event's eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event's eventPhase attribute value is AT_TARGET.

When set to true, options's passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in § 2.8 Observing event listeners.

When set to true, options's once indicates that the callback will only be invoked once after which the event listener will be removed.

If an AbortSignal is passed for options's signal, then the event listener will be removed when signal is aborted.

The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture.

MDN Reference
Parameters
- type: string
- callback: EventListenerOrEventListenerObject
- Optionaloptions: boolean | AddEventListenerOptions
Returns void
Inherited from CharacterData.addEventListener

after

after(...nodes): void
Inserts nodes just after node, while replacing strings in nodes with equivalent Text nodes.

Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

MDN Reference
Parameters
- Rest...nodes: (string | Node)[]
Returns void
Inherited from CharacterData.after

appendChild

appendChild<T>(node): T
MDN Reference
Type Parameters
- T extends Node
Parameters
- node: T
Returns T
Inherited from CharacterData.appendChild

appendData

appendData(data): void
MDN Reference
Parameters
- data: string
Returns void
Inherited from CharacterData.appendData

before

before(...nodes): void
Inserts nodes just before node, while replacing strings in nodes with equivalent Text nodes.

Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

MDN Reference
Parameters
- Rest...nodes: (string | Node)[]
Returns void
Inherited from CharacterData.before

cloneNode

cloneNode(deep?): Node
Returns a copy of node. If deep is true, the copy also includes the node's descendants.

MDN Reference
Parameters
- Optionaldeep: boolean
Returns Node
Inherited from CharacterData.cloneNode

compareDocumentPosition

compareDocumentPosition(other): number
Returns a bitmask indicating the position of other relative to node.

MDN Reference
Parameters
- other: Node
Returns number
Inherited from CharacterData.compareDocumentPosition

contains

contains(other): boolean
Returns true if other is an inclusive descendant of node, and false otherwise.

MDN Reference
Parameters
- other: Node
Returns boolean
Inherited from CharacterData.contains

deleteData

deleteData(offset, count): void
MDN Reference
Parameters
- offset: number
- count: number
Returns void
Inherited from CharacterData.deleteData

dispatchEvent

dispatchEvent(event): boolean
Dispatches a synthetic event event to target and returns true if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise.

MDN Reference
Parameters
- event: Event
Returns boolean
Inherited from CharacterData.dispatchEvent

getRootNode

getRootNode(options?): Node
Returns node's root.

MDN Reference
Parameters
- Optionaloptions: GetRootNodeOptions
Returns Node
Inherited from CharacterData.getRootNode

hasChildNodes

hasChildNodes(): boolean
Returns whether node has children.

MDN Reference

Returns boolean
Inherited from CharacterData.hasChildNodes

insertBefore

insertBefore<T>(node, child): T
MDN Reference
Type Parameters
- T extends Node
Parameters
- node: T
- child: Node
Returns T
Inherited from CharacterData.insertBefore

insertData

insertData(offset, data): void
MDN Reference
Parameters
- offset: number
- data: string
Returns void
Inherited from CharacterData.insertData

isDefaultNamespace

isDefaultNamespace(namespace): boolean
MDN Reference
Parameters
- namespace: string
Returns boolean
Inherited from CharacterData.isDefaultNamespace

isEqualNode

isEqualNode(otherNode): boolean
Returns whether node and otherNode have the same properties.

MDN Reference
Parameters
- otherNode: Node
Returns boolean
Inherited from CharacterData.isEqualNode

isSameNode

isSameNode(otherNode): boolean
MDN Reference
Parameters
- otherNode: Node
Returns boolean
Inherited from CharacterData.isSameNode

lookupNamespaceURI

lookupNamespaceURI(prefix): string
MDN Reference
Parameters
- prefix: string
Returns string
Inherited from CharacterData.lookupNamespaceURI

lookupPrefix

lookupPrefix(namespace): string
MDN Reference
Parameters
- namespace: string
Returns string
Inherited from CharacterData.lookupPrefix

normalize

normalize(): void
Removes empty exclusive Text nodes and concatenates the data of remaining contiguous exclusive Text nodes into the first of their nodes.

MDN Reference

Returns void
Inherited from CharacterData.normalize

remove

remove(): void
Removes node.

MDN Reference

Returns void
Inherited from CharacterData.remove

removeChild

removeChild<T>(child): T
MDN Reference
Type Parameters
- T extends Node
Parameters
- child: T
Returns T
Inherited from CharacterData.removeChild

removeEventListener

removeEventListener(type, callback, options?): void
Removes the event listener in target's event listener list with the same type, callback, and options.

MDN Reference
Parameters
- type: string
- callback: EventListenerOrEventListenerObject
- Optionaloptions: boolean | EventListenerOptions
Returns void
Inherited from CharacterData.removeEventListener

replaceChild

replaceChild<T>(node, child): T
MDN Reference
Type Parameters
- T extends Node
Parameters
- node: Node
- child: T
Returns T
Inherited from CharacterData.replaceChild

replaceData

replaceData(offset, count, data): void
MDN Reference
Parameters
- offset: number
- count: number
- data: string
Returns void
Inherited from CharacterData.replaceData

replaceWith

replaceWith(...nodes): void
Replaces node with nodes, while replacing strings in nodes with equivalent Text nodes.

Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

MDN Reference
Parameters
- Rest...nodes: (string | Node)[]
Returns void
Inherited from CharacterData.replaceWith

substringData

substringData(offset, count): string
MDN Reference
Parameters
- offset: number
- count: number
Returns string
Inherited from CharacterData.substringData

Interface Comment

Hierarchy

Index

Properties

Methods

Properties

ReadonlyATTRIBUTE_NODE

ReadonlybaseURI

ReadonlyCDATA_SECTION_NODE

ReadonlychildNodes

ReadonlyCOMMENT_NODE

data

ReadonlyDOCUMENT_FRAGMENT_NODE

ReadonlyDOCUMENT_NODE

ReadonlyDOCUMENT_POSITION_CONTAINED_BY

ReadonlyDOCUMENT_POSITION_CONTAINS

ReadonlyDOCUMENT_POSITION_DISCONNECTED

ReadonlyDOCUMENT_POSITION_FOLLOWING

ReadonlyDOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC

ReadonlyDOCUMENT_POSITION_PRECEDING

ReadonlyDOCUMENT_TYPE_NODE

ReadonlyELEMENT_NODE

ReadonlyENTITY_NODE

ReadonlyENTITY_REFERENCE_NODE

ReadonlyfirstChild

ReadonlyisConnected

ReadonlylastChild

Readonlylength

ReadonlynextElementSibling

ReadonlynextSibling

ReadonlynodeName

ReadonlynodeType

nodeValue

ReadonlyNOTATION_NODE

ReadonlyownerDocument

ReadonlyparentElement

ReadonlyparentNode

ReadonlypreviousElementSibling

ReadonlypreviousSibling

ReadonlyPROCESSING_INSTRUCTION_NODE

ReadonlyTEXT_NODE

textContent

Methods

addEventListener

Parameters

Returns void

after

Parameters

Returns void

appendChild

Type Parameters

Parameters

Returns T

appendData

Parameters

Returns void

before

Parameters

Returns void

cloneNode

Parameters

Returns Node

compareDocumentPosition

Parameters

Returns number

contains

Parameters

Returns boolean

deleteData

Parameters

Returns void

dispatchEvent

Parameters

Returns boolean

getRootNode

Parameters

Returns Node

hasChildNodes

Returns boolean

insertBefore

`Readonly`ATTRIBUTE_NODE

`Readonly`baseURI

`Readonly`CDATA_SECTION_NODE

`Readonly`childNodes

`Readonly`COMMENT_NODE

`Readonly`DOCUMENT_FRAGMENT_NODE

`Readonly`DOCUMENT_NODE

`Readonly`DOCUMENT_POSITION_CONTAINED_BY

`Readonly`DOCUMENT_POSITION_CONTAINS

`Readonly`DOCUMENT_POSITION_DISCONNECTED

`Readonly`DOCUMENT_POSITION_FOLLOWING

`Readonly`DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC

`Readonly`DOCUMENT_POSITION_PRECEDING

`Readonly`DOCUMENT_TYPE_NODE

`Readonly`ELEMENT_NODE

`Readonly`ENTITY_NODE

`Readonly`ENTITY_REFERENCE_NODE

`Readonly`firstChild

`Readonly`isConnected

`Readonly`lastChild

`Readonly`length

`Readonly`nextElementSibling

`Readonly`nextSibling

`Readonly`nodeName

`Readonly`nodeType

`Readonly`NOTATION_NODE

`Readonly`ownerDocument

`Readonly`parentElement

`Readonly`parentNode

`Readonly`previousElementSibling

`Readonly`previousSibling

`Readonly`PROCESSING_INSTRUCTION_NODE

`Readonly`TEXT_NODE