HTMLAnchorElement

ReplaceChild

Sintaxis:

ReplaceChild(<NuevoNodo>, <ViejoNodo>)

Parámetros:

Tipo: HTMLAttribute, HTMLElement, HTMLButtonElement, HTMLInputElement, HTMLHeadElement, HTMLHtmlElement, HTMLIFrameElement, HTMLEmbedElement, HTMLFrameElement, HTMLFrameSetElement, HTMLMetaElement, HTMLObjectElement, HTMLScriptElement, HTMLTableElement, HTMLTableRowElement, HTMLTableCellElement, HTMLTableColElement, HTMLTableCaptionElement, HTMLDivElement, HTMLHRElement, HTMLPreElement, HTMLImageElement, HTMLLinkElement, HTMLAnchorElement, HTMLAppletElement, HTMLFormElement, HTMLDocument, HTMLText, HTMLComment.
Un nuevo nodo hijo.

Tipo: HTMLAttribute, HTMLElement, HTMLButtonElement, HTMLInputElement, HTMLHeadElement, HTMLHtmlElement, HTMLIFrameElement, HTMLEmbedElement, HTMLFrameElement, HTMLFrameSetElement, HTMLMetaElement, HTMLObjectElement, HTMLScriptElement, HTMLTableElement, HTMLTableRowElement, HTMLTableCellElement, HTMLTableColElement, HTMLTableCaptionElement, HTMLDivElement, HTMLHRElement, HTMLPreElement, HTMLImageElement, HTMLLinkElement, HTMLAnchorElement, HTMLAppletElement, HTMLFormElement, HTMLDocument, HTMLText, HTMLComment.
El nodo hijo existente.

Valor devuelto:

El valor del nodo anterior.

Descripción:

Reemplaza un nodo hijo especificado en el parámetro <ViejoNodo> por un nodo especificado en el parámetro <NuevoNodo>.
Si el nuevo nodo es DocumentFragment, el nodo reemplazado será reemplazado por todos los nodos hijos del fragmento de documento.
Si el nuevo nodo ya está incluido en el árbol del documento, primero se elimina de los nodos hijos del padre anterior y luego se inserta en la lista de nodos hijos del nuevo padre.

Disponibilidad:

Cliente ligero, cliente móvil, servidor, cliente grueso, conexión externa, aplicación móvil (cliente), aplicación móvil (servidor), servidor independiente móvil.

Nota:

Se desencadena una excepción:

• si el nodo dado no permite que se agregue como nodo hijo o si el nodo agregado es un padre para el dado.
• si el nodo se agrega a sí mismo.
• si el nodo dado – Document y el segundo nodo DocumentType o Element se agrega.
• si el nodo que se agrega fue creado por un documento diferente al que creó el nodo dado.
• si el nodo dado está en modo de solo lectura o si el padre anterior del nodo agregado está en modo de solo lectura.
• si no se encuentra el nodo reemplazado.
• si el nodo agregado es un nodo hijo para el nodo Document y la implementación no admite la eliminación de nodos DocumentType y Element del nodo Document.

Disponible desde:

Disponible desde la versión 8.2.