Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

document.createElement — crear un elemento DOM

document.createElement crea un nuevo elemento DOM con el nombre indicado. No lo inserta automáticamente en el documento.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

document.createElement(localName)
document.createElement(localName, options)

document.createElement(localName, options) devuelve un elemento nuevo sin padre. El argumento localName es el nombre de un elemento, no código HTML. Define el contenido mediante textContent e inserta el elemento por separado, por ejemplo, con appendChild.

En un documento HTML, el nombre se convierte a minúsculas ASCII. Un nombre no válido provoca una DOMException llamada InvalidCharacterError. Usa createElementNS para elegir explícitamente un espacio de nombres.

En el argumento opcional options, la propiedad is indica el nombre registrado de un elemento personalizado que extiende el elemento incorporado indicado por localName. Para crear un elemento personalizado autónomo, pasa su nombre registrado directamente como localName, no como options.is. Safari no admite elementos incorporados personalizados, por lo que este uso de options.is no funciona en todos los navegadores.

El ejemplo solo muestra la llamada con un argumento, sin options. Requiere un documento HTML en un navegador; la compatibilidad con JavaScript no garantiza por sí sola que document esté disponible.

Ejemplos

const element = document.createElement("DIV");
element.textContent = "Hello";
console.log(element.localName);
console.log(element.textContent);
console.log(element.parentNode === null);

Resultado

div
Hello
true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes