<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="domnode.insertbefore" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>DOMNode::insertBefore</refname>

<refpurpose>

Añade un nuevo hijo antes de un nodo de referencia.

</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis role="DOMNode">

<modifier>public</modifier> <type class="union"><type>DOMNode</type><type>false</type></type><methodname>DOMNode::insertBefore</methodname>

<methodparam><type>DOMNode</type><parameter>node</parameter></methodparam>

<methodparam choice="opt"><type class="union"><type>DOMNode</type><type>null</type></type><parameter>child</parameter><initializer>&null;</initializer></methodparam>

</methodsynopsis>

<para>

Esta función inserta un nuevo nodo justo antes del nodo de referencia.

Si se planea realizar modificaciones posteriores en el hijo añadido, debe

utilizarse el nodo devuelto.

</para>

<para>

Al utilizar un nodo existente, este será movido.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>node</parameter></term>

<listitem>

<para>

El nuevo nodo.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>child</parameter></term>

<listitem>

<para>

El nodo referenciado. Si no se especifica, <parameter>node</parameter>

será añadido a los hijos.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

El nodo insertado o &false; en caso de error.

</para>

</refsect1>

<refsect1 role="errors">

&reftitle.errors;

<simpara>

Puede lanzar una <exceptionname>DOMException</exceptionname> con los

siguientes códigos de error:

</simpara>

<para>

<variablelist>

<varlistentry>

<term><constant>DOM_NO_MODIFICATION_ALLOWED_ERR</constant></term>

<listitem>

<para>

Lanzado si el nodo es de solo lectura o si el padre anterior al nodo a

insertar es de solo lectura.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>

<listitem>

<para>

Lanzado si este nodo es de un tipo que no permite hijos del tipo del nodo

<parameter>node</parameter>, o si el nodo a añadir es uno de los ancestros

de este nodo o este nodo mismo.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>

<listitem>

<para>

Lanzado si <parameter>node</parameter> ha sido creado desde un documento

diferente al que ha creado este nodo.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>DOM_NOT_FOUND_ERR</constant></term>

<listitem>

<para>

Lanzado si <parameter>child</parameter> no es un hijo de este nodo.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><methodname>DOMNode::appendChild</methodname></member>

</simplelist>

</para>

</refsect1>

</refentry>