JavaScript: The Definitive Guide, Fifth Edition > Client-Side JavaScript Reference > Node.replaceChild( ): replace a child node with a new node

Table of Contents

Download Safari Books Online apps: Apple iOS | Android

Entire Site

Free Trial

Safari Books Online is a digital library providing on-demand subscription access to thousands of learning resources.

This Book

JavaScript: The Definitive Guide, Fifth Edition

Search

Dedication

Preface

Ch. 1. Introduction to JavaScript

Pt. I. Core JavaScript

Pt. II. Client-Side JavaScript

Pt. III. Core JavaScript Reference

Pt. IV. Client-Side JavaScript Reference

Ch. 25. Client-Side JavaScript Reference

Anchor: the target of a hypertext link

Anchor.focus( ): scroll to make the anchor location visible

Applet: an applet embedded in a web page

Attr: an attribute of a document element

Button: see Input

Canvas: an HTML element for scripted drawing

Canvas.getContext( ): return a context for drawing on the canvas

CanvasGradient: a color gradient for use in a canvas

CanvasGradient.addColorStop( ): add a change of color at some point in the gradient

CanvasPattern: an image-based pattern for use in a Canvas

CanvasRenderingContext2D: the object used for drawing on a canvas

CanvasRenderingContext2D.arc( ): add an arc to the current subpath of a canvas, using a center point and radius

CanvasRenderingContext2D.arcTo( ): add an arc of a circle to the current subpath, using tangent points and a radius

CanvasRenderingContext2D.beginPath( ): start a new collection of subpaths in a canvas

CanvasRenderingContext2D.bezierCurveTo( ): add a cubic Bézier curve to the current subpath

CanvasRenderingContext2D.clearRect( ): erase a rectangular area of a canvas

CanvasRenderingContext2D.clip( ): set the clipping path of a canvas

CanvasRenderingContext2D.closePath( ): closes an open subpath

CanvasRenderingContext2D.createLinearGradient( ): create a linear color gradient

CanvasRenderingContext2D.createPattern( ): create a pattern of tiled images

CanvasRenderingContext2D.createRadialGradient( ): create a radial color gradient

CanvasRenderingContext2D.drawImage( ): draw an image

CanvasRenderingContext2D.fill( ): fill the path

CanvasRenderingContext2D.fillRect( ): fill a rectangle

CanvasRenderingContext2D.globalCompositeOperation: specifies how colors are combined on the canvas

CanvasRenderingContext2D.lineCap: specifies how the ends of lines are rendered

CanvasRenderingContext2D.lineJoin: specifies how vertices are rendered

CanvasRenderingContext2D.lineTo( ): add a straight line to the current subpath

CanvasRenderingContext2D.miterLimit: maximum-miter-length-to-line-width ratio

CanvasRenderingContext2D.moveTo( ): sets the current position and begins a new subpath

CanvasRenderingContext2D.quadraticCurveTo( ): add a quadratic Bezier curve to the current subpath

CanvasRenderingContext2D.rect( ): add a rectangle subpath to the path

CanvasRenderingContext2D.restore( ): reset drawing state to saved values

CanvasRenderingContext2D.rotate( ): rotate the coordinate system of the canvas

CanvasRenderingContext2D.save( ): save a copy of the current graphics state

CanvasRenderingContext2D.scale( ): scale the user coordinate system of the canvas

CanvasRenderingContext2D.stroke( ): draw the current path

CanvasRenderingContext2D.strokeRect( ): draw a rectangle

CanvasRenderingContext2D.translate( ): translate the user coordinate system of the canvas

CDATASection: a CDATA node in an XML document

CharacterData: common functionality for Text and Comment nodes

CharacterData.appendData( ): append a string to a Text or Comment node

CharacterData.deleteData( ): delete characters from a Text or Comment node

CharacterData.insertData( ): insert a string into a Text or Comment node

CharacterData.replaceData( ): replace characters of a Text or Comment node with a string

CharacterData.substringData( ): extract a substring from a Text or Comment node

Checkbox: see Input

Comment: an HTML or XML comment

CSS2Properties: a set of CSS attributes and their values

CSSRule: a rule in a CSS stylesheet

CSSStyleSheet: a CSS stylesheet

CSSStyleSheet.addRule( ): IE-specific method to insert a rule into a stylesheet

CSSStyleSheet.deleteRule( ): delete a rule from a stylesheet

CSSStyleSheet.insertRule( ): insert a rule into a stylesheet

CSSStyleSheet.removeRule( ): IE-specific method to remove a rule from a stylesheet

Document: an HTML or XML document

Document.addEventListener( ): see Element.addEventListener( )

Document.attachEvent( ): see Element.attachEvent( )

Document.createAttribute( ): create a new Attr node

Document.createAttributeNS( ): create an Attr with a name and namespace

Document.createCDATASection( ): create a new CDATASection node

Document.createComment( ): create a new Comment node

Document.createDocumentFragment( ): create a new, empty DocumentFragment node

Document.createElement( ): create a new Element node

Document.createElementNS( ): create a new Element node using a namespace

Document.createEvent( ): create an Event object

Document.createExpression( ): create an XPath expression for later evaluation

Document.createProcessingInstruction( ): create a ProcessingInstruction node

Document.createRange( ): create a Range object

Document.createTextNode( ): create a new Text node

Document.detachEvent( ): see Element.detachEvent( )

Document.dispatchEvent( ): see Element.dispatchEvent( )

Document.evaluate( ): evaluate an XPath expression

Document.getElementById( ): find an element with the specified unique ID

Document.getElementsByTagName( ): return all Element nodes with the specified name

Document.getElementsByTagNameNS( ): return all Element nodes with a specified name and namespace

Document.importNode( ): copy a node from another document for use in this document

Document.loadXML( ): populate this Document by parsing a string of XML markup

Document.removeEventListener( ): see Element.removeEventListener( )

DocumentFragment: adjacent nodes and their subtrees

DocumentType: the DTD of an XML document

DOMException: signal exceptions or errors for core DOM objects

DOMImplementation: methods independent of any particular document

DOMImplementation.createDocument( ): create a new Document and the specified root element

DOMImplementation.createDocumentType( ): create a DocumentType node

DOMImplementation.hasFeature( ): determine whether the implementation supports a feature

DOMParser: parses XML markup to create a Document

DOMParser.parseFromString( ): parse XML markup

Element: an HTML or XML element

Element.addEventListener( ): register an event handler

Element.attachEvent( ): register an event handler

Element.detachEvent( ): delete an event listener

Element.dispatchEvent( ): dispatch a synthetic event to this node

Element.getAttribute( ): return the string value of a named attribute

Element.getAttributeNode( ): return the Attr node for the named attribute

Element.getAttributeNodeNS( ): return the Attr node for an attribute with a namespace

Element.getAttributeNS( ): get the value of an attribute that uses namespaces

Element.getElementsByTagName( ): find descendant elements with a specified tag name

Element.getElementsByTagNameNS( ): return descendant elements with the specified name and namespace

Element.hasAttribute( ): determine whether this element has a specified attribute

Element.hasAttributeNS( ): determine whether this element has a specified attribute

Element.removeAttribute( ): delete a named attribute of an element

Element.removeAttributeNode( ): remove an Attr node from an element

Element.removeAttributeNS( ): delete an attribute specified by name and namespace

Element.removeEventListener( ): delete an event listener

Element.setAttribute( ): create or change an attribute of an element

Element.setAttributeNode( ): add a new Attr node to an Element

Element.setAttributeNodeNS( ): add a namespace Attr node to an Element

Element.setAttributeNS( ): create or change an attribute with a namespace

Event: information about an event

Event.initEvent( ): initialize the properties of a new event

Event.preventDefault( ): cancel default action of an event

Event.stopPropagation( ): do not dispatch an event any further

ExternalInterface: a bidirectional interface to Flash

ExternalInterface.addCallback( ): expose an ActionScript method for execution from JavaScript

ExternalInterface.call( ): call a JavaScript function from ActionScript

FileUpload: see Input

FlashPlayer: plug-in for Flash movies

FlashPlayer.GetVariable( ): return a value defined in a Flash movie

FlashPlayer.GotoFrame( ): skip to the specified frame of a movie

FlashPlayer.IsPlaying( ): check whether a movie is playing

FlashPlayer.LoadMovie( ): load an auxiliary movie

FlashPlayer.Pan( ): move the viewport of the movie

FlashPlayer.PercentLoaded( ): determine how much of the movie has loaded

FlashPlayer.Play( ): play a movie

FlashPlayer.Rewind( ): rewind the movie to its first frame

FlashPlayer.SetVariable( ): set a variable defined by a Flash movie

FlashPlayer.SetZoomRect( ): set the viewport of a movie

FlashPlayer.StopPlay( ): stop the movie

FlashPlayer.TotalFrames( ): return the length of the movie, in frames

FlashPlayer.Zoom( ): zoom in or out

Form: a <form> in an HTML document

Form.elements[]: the input elements of a form

Form.onreset: event handler invoked when a form is reset

Form.onsubmit: event handler invoked when a form is submitted

Form.reset( ): reset the elements of a form to their default values

Form.submit( ): submit form data to a web server

Frame: a <frame> in an HTML document

Hidden: see Input

History: the URL history of the browser

History.back( ): return to the previous URL

History.forward( ): visit the next URL

History.go( ): revisit a URL

HTMLCollection: array of HTML elements accessible by position or name

HTMLCollection.item( ): get an element by position

HTMLCollection.namedItem( ): get an element by name

HTMLDocument: the root of an HTML document tree

HTMLDocument.all[]: all HTML elements in a document

HTMLDocument.close( ): close an open document and display it

HTMLDocument.cookie: the cookie(s) of the document

HTMLDocument.domain: the security domain of a document

HTMLDocument.getElementsByName( ): find elements with the specified name attribute

HTMLDocument.open( ): begin a new document, erasing the current one

HTMLDocument.write( ): append HTML text to an open document

HTMLDocument.writeln( ): append HTML text and a newline to an open document

HTMLElement: an element in an HTML document

HTMLElement.onclick: event handler invoked when the user clicks on an element

HTMLElement.ondblclick: event handler invoked when the user double-clicks on an element

HTMLElement.onkeydown: event handler invoked when the user presses a key

HTMLElement.onkeypress: event handler invoked when the user presses a key

HTMLElement.onkeyup: event handler invoked when the user releases a key

HTMLElement.onmousedown: event handler invoked when the user presses a mouse button

HTMLElement.onmousemove: event handler invoked when the mouse moves within an element

HTMLElement.onmouseout: event handler invoked when mouse moves out of an element

HTMLElement.onmouseover: event handler invoked when the mouse moves over an element

HTMLElement.onmouseup: event handler invoked when the user releases a mouse button

HTMLElement.scrollIntoView( ): make an element visible

IFrame: an <iframe> in an HTML document

Image: an image in an HTML document

Image.onabort: event handler invoked when the user aborts image loading

Image.onerror: event handler invoked when an error occurs during image loading

Image.onload: event handler invoked when an image finishes loading

Input: an input element in an HTML form

Input.blur( ): remove keyboard focus from a form element

Input.click( ): simulate a mouse click on a form element

Input.focus( ): give keyboard focus to a form element

Input.onblur: the handler invoked when a form element loses focus

Input.onchange: event handler invoked when a form element's value changes

Input.onclick: event handler invoked when a form element is clicked

Input.onfocus: event handler invoked when a form element gains focus

Input.select( ): select the text in a form element

JavaArray, JavaClass, JavaObject, JavaPackage: see Part III

JSObject: Java representation of a JavaScript object

JSObject.call( ): invoke a method of a JavaScript object

JSObject.eval( ): evaluate a string of JavaScript code

JSObject.getMember( ): read a property of a JavaScript object

JSObject.getSlot( ): read an array element of a JavaScript object

JSObject.getWindow( ): return initial JSObject for browser window

JSObject.removeMember( ): delete a property of a JavaScript object

JSObject.setMember( ): set a property of a JavaScript object

JSObject.setSlot( ): set an array element of a JavaScript object

JSObject.toString( ): return the string value of a JavaScript object

KeyEvent: details about a keyboard event

Layer: an obsolete Netscape API

Link: a hyperlink or anchor in an HTML document

Link.blur( ): take keyboard focus away from a hyperlink

Link.focus( ): make a link visible and give it keyboard focus

Link.onclick: event handler invoked when a Link is clicked

Link.onmouseout: event handler invoked when the mouse leaves a link

Link.onmouseover: event handler invoked when the mouse goes over a link

Location: represents and controls browser location

Location.reload( ): reload the current document

Location.replace( ): replace one displayed document with another

MimeType: represents a MIME datatype

MouseEvent: details about a mouse event

MouseEvent.initMouseEvent( ): initialize the properties of a MouseEvent object

Navigator: information about the browser in use

Navigator.javaEnabled( ): test whether Java is available

Node: a node in a document tree

Node.appendChild( ): insert a node as the last child of this node

Node.cloneNode( ): duplicate a node and, optionally, all of its descendants

Node.hasAttributes( ): determine whether a node has attributes

Node.hasChildNodes( ): determine whether a node has children

Node.insertBefore( ): insert a node into the document tree before the specified node

Node.isSupported( ): determine if a node supports a feature

Node.normalize( ): merge adjacent Text nodes and remove empty ones

Node.removeChild( ): remove (and return) the specified child of this node

Node.replaceChild( ): replace a child node with a new node

Node.selectNodes( ): select nodes with an XPath query

Node.transformNode( ): transform a node to a string using XSLT

Node.transformNodeToObject( ): transform a node to a document using XSLT

NodeList: a read-only array of nodes

NodeList.item(): get an element of a NodeList

Option: an option in a Select element

Packages: see Packages in Part III

Password: see Input

Plugin: describes an installed plug-in

ProcessingInstruction : a processing instruction in an XML document

Radio: see Input

Range: represents a contiguous range of a document

Range.cloneContents(): copy range contents into a DocumentFragment

Range.cloneRange(): make a copy of this range

Range.collapse(): make one boundary point equal to the other

Range.compareBoundaryPoints(): compare positions of two ranges

Range.deleteContents(): delete a region of the document

Range.detach(): free a Range object

Range.extractContents( ): delete document content and return it in a DocumentFragment

Range.insertNode( ): insert a node at the start of a range

Range.selectNode(): set range boundaries to a node

Range.selectNodeContents( ): set range boundaries to the children of a node

Range.setEnd( ): set the end point of a range

Range.setEndAfter( ): end a range after a specified node

Range.setEndBefore( ): end a range before the specified node

Range.setStart( ): set the start point of a range

Range.setStartAfter( ): start a range after the specified node

Range.setStartBefore( ): start a range before the specified node

Range.surroundContents( ): surround range contents with the specified node

Range.toString( ): get range contents as a plain-text string

RangeException: signals a range-specific exception

Reset: see Input

Screen: provides information about the display

Select: a graphical selection list

Select.add( ): insert an <option> element

Select.blur( ): take keyboard focus away from this element

Select.focus( ): give keyboard focus to this element

Select.onchange: event handler invoked when the selection changes

Select.options[]: the choices in a Select object

Select.remove( ): remove an <option>

Style: see CSS2Properties

Submit: see Input

Table: a <table> in an HTML document

Table.createCaption( ): get or create a <caption>

Table.createTFoot( ): get or create a <tfoot>

Table.createTHead( ): get or create a <thead>

Table.deleteCaption( ): delete the <caption> of a table

Table.deleteRow( ): delete a row of a table

Table.deleteTFoot( ): delete the <tfoot> of a table

Table.deleteTHead( ): delete the <thead> of a table

Table.insertRow( ): add a new, empty row to the table

TableCell: cell in an HTML table

TableRow: a <tr> element in an HTML table

TableRow.deleteCell( ): delete a cell in a table row

TableRow.insertCell( ): insert a new, empty <td> element into a table row

TableSection: a header, footer, or body section of a table

TableSection.deleteRow( ): delete a row within a table section

TableSection.insertRow( ): insert a new, empty row into this table section

Text: a run of text in an HTML or XML document

Text.splitText( ): split a Text node in two

Textarea: a multiline text input area

Textarea.blur( ): take keyboard focus away from this element

Textarea.focus( ): give keyboard focus to this element

Textarea.onchange: event handler invoked when input value changes

Textarea.select( ): select the text in this element

TextField: see Input

UIEvent: details about user-interface events

UIEvent.initUIEvent( ): initialize the properties of a UIEvent object

Window: a web browser window or frame

Window.addEventListener( ): see Element.addEventListener( )

Window.alert( ): display a message in a dialog box

Window.attachEvent( ): see Element.attachEvent( )

Window.blur( ): remove keyboard focus from a top-level window

Window.clearInterval( ): stop periodically executing code

Window.clearTimeout( ): cancel deferred execution

Window.close( ): close a browser window

Window.confirm( ): ask a yes-or-no question

Window.defaultStatus: the default status line text

Window.detachEvent( ): see Element.detachEvent( )

Window.focus( ): give keyboard focus to a window

Window.getComputedStyle( ): retrieve the CSS styles used to render an element

Window.moveBy( ): move a window to a relative position

Window.moveTo( ): move a window to an absolute position

Window.onblur: event handler invoked when the window loses keyboard focus

Window.onerror: error handler invoked when a JavaScript error occurs

Window.onfocus: event handler invoked when a window is given focus

Window.onload: event handler invoked when a document finishes loading

Window.onresize: event handler invoked when a window is resized

Window.onunload: the handler invoked when the browser leaves a page

Window.open( ): open a new browser window or locate a named window

Window.print( ): print the document

Window.prompt( ): get user input with a dialog box

Window.removeEventListener( ): see Element.removeEventListener( )

Window.resizeBy( ): resize a window by a relative amount

Window.resizeTo( ): resize a window

Window.scrollBy( ): scroll the document by a relative amount

Window.scrollTo( ): scroll the document

Window.setInterval( ): periodically execute specified code

Window.setTimeout( ): defer execution of code

Window.status: specify a transient status-line message

XMLHttpRequest: An HTTP request and response

XMLHttpRequest.abort( ): cancel an HTTP request

XMLHttpRequest.getAllResponseHeaders( ): return unparsed HTTP response headers

XMLHttpRequest.getResponseHeader( ): get the value of a named HTTP response header

XMLHttpRequest.onreadystatechange: event handler function invoked when readyState changes

XMLHttpRequest.open( ): initialize HTTP request parameters

XMLHttpRequest.send( ): send an HTTP request

XMLHttpRequest.setRequestHeader( ): add a HTTP request header to the request

XMLSerializer: serializes XML documents and nodes

XMLSerializer.serializeToString( ): convert an XML document or node to a string

XPathExpression: a compiled XPath query

XPathExpression.evaluate( ): evaluate a compiled XPath query

XPathResult: the result of an XPath query

XPathResult.iterateNext( ): return the next node that matches an XPath query

XPathResult.snapshotItem( ): return a node that matches an XPath query

XSLTProcessor: transform XML with XSLT stylesheets

XSLTProcessor.clearParameters( ): delete all stylesheet parameter values

XSLTProcessor.getParameter( ): return the value of a named parameter

XSLTProcessor.importStylesheet( ): specify an XSLT stylesheet for transformations

XSLTProcessor.removeParameter( ): delete a parameter value

XSLTProcessor.reset( ): restore an XSLTProcessor to its default state

XSLTProcessor.setParameter( ): set a stylesheet parameter

XSLTProcessor.transformToDocument( ): transform a node or document to a new document

XSLTProcessor.transformToFragment( ): transform a node or document to a DocumentFragment

Colophon

Index

Node.replaceChild( ): replace a child node with a new nodeDOM Level 1 Core

Synopsis

Node replaceChild(NodenewChild,
                  Node oldChild)
    throws DOMException;

Arguments

newChild: The replacement node.
oldChild: The node to be replaced.

Returns

The node that was removed from the document and replaced.

Throws

This method may throw a DOMException with the following code values:

HIERARCHY_REQUEST_ERR: This node does not allow children, it does not allow children of the specified type, or newChild is an ancestor of this node (or is this node itself).
WRONG_DOCUMENT_ERR: newChild and this node have different values for ownerDocument.
NO_MODIFICATION_ALLOWED_ERR: This node is read-only and does not allow replacement, or newChild is the child of a node that does not allow removals.
NOT_FOUND_ERR: oldChild is not a child of this node.

You are currently reading a PREVIEW of this book.

Get instant access to over
$1 million worth of books and videos.

Start a Free Trial