CKTIS / JavaScript
document.createElement — criar um elemento DOM
document.createElement cria um novo elemento DOM com o nome especificado. Não o insere automaticamente no documento.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
document.createElement(localName)
document.createElement(localName, options)document.createElement(localName, options) devolve um novo elemento sem nó pai. O argumento localName é o nome de um elemento, não código HTML. Define o conteúdo através de textContent e insere o elemento separadamente, por exemplo, com appendChild.
Num documento HTML, o nome é convertido para minúsculas ASCII. Um nome inválido lança uma DOMException com o nome InvalidCharacterError. Usa createElementNS para escolher explicitamente um espaço de nomes.
No argumento opcional options, a propriedade is indica o nome registado de um elemento personalizado que estende o elemento incorporado indicado por localName. Para criar um elemento personalizado autónomo, passa o seu nome registado diretamente como localName, e não como options.is. O Safari não suporta elementos incorporados personalizados, pelo que esta utilização de options.is não funciona em todos os navegadores.
O exemplo mostra apenas a chamada com um argumento, sem options. Requer um documento HTML num navegador; o suporte de JavaScript, por si só, não garante que document esteja disponível.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.