DOM e Browser API

DOMException: Failed to execute 'define' on 'CustomElementRegistry': "mywidget" is not a valid custom element name. – JavaScript DOM_CUSTOM_ELEMENT_NO_HYPHEN

DOM_CUSTOM_ELEMENT_NO_HYPHEN

La specifica W3C Web Components impone che i nomi dei Custom Elements contengano almeno un trattino `-` (es. `my-widget` anziché `mywidget`) per evitare collisioni con i tag HTML standard futuri.

Categoria: JavaScriptGruppo: DOM e Browser APIConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 1 volta

Cosa significa questo errore?

La specifica W3C Web Components impone che i nomi dei Custom Elements contengano almeno un trattino `-` (es. `my-widget` anziché `mywidget`) per evitare collisioni con i tag HTML standard futuri.

Messaggio originale

DOMException: Failed to execute 'define' on 'CustomElementRegistry': "mywidget" is not a valid custom element name.

Contesto e parole chiave

Alias

  • custom element missing hyphen
  • is not a valid custom element name

Messaggi alternativi

  • nome elemento personalizzato non valido deve contenere un trattino

Prodotti

  • Motore JavaScript ECMAScript (V8, SpiderMonkey, JavaScriptCore) / DOM Web APIs

Piattaforme

  • Browser Web
  • Bun
  • Deno
  • Multipiattaforma
  • Node.js

Parole chiave

  • DOM e Browser API
  • DOM_CUSTOM_ELEMENT_NO_HYPHEN
  • ecmascript
  • errore-javascript-custom-element-missing-hyphen-tag
  • javascript
  • javascript.dom.custom-element-missing-hyphen
  • js

Cause possibili

Origine del problema per JavaScript: DOMException — Nome Custom Element non valido (trattino obbligatorio)

La specifica W3C Web Components impone che i nomi dei Custom Elements contengano almeno un trattino `-` (es. `my-widget` anziché `mywidget`) per evitare collisioni con i tag HTML standard futuri.

molto comune

Diagnosi

Ispezione diagnostica JavaScript per JavaScript: DOMException — Nome Custom Element non valido (trattino obbligatorio)

Aprire la Console dei Developer Tools del browser (F12) o consultare lo stack trace a terminale.

Come leggere il risultato. Evidenzia la linea esatta di codice sorgente, l'oggetto target e il tipo di eccezione ECMAScript scatenata.

Risoluzione

Procedura di risoluzione per JavaScript: DOMException — Nome Custom Element non valido (trattino obbligatorio)

Difficoltà: facileRischio: basso

Applicare la correzione al codice secondo gli standard ECMAScript e le specifiche W3C/WHATWG.

  1. Verificare la compatibilità del tipo di dato o la presenza dell'elemento DOM
  2. Aggiungere i controlli di validazione o gestione degli errori con try/catch
  3. Ricaricare l'applicazione o rieseguire il test unitario

Domande frequenti

Come risolvere l'errore DOM_CUSTOM_ELEMENT_NO_HYPHEN in JavaScript?

La specifica W3C Web Components impone che i nomi dei Custom Elements contengano almeno un trattino `-` (es. `my-widget` anziché `mywidget`) per evitare collisioni con i tag HTML standard futuri.

Approfondimenti

Schede correlate