Element.localName is a read-only string: the local part of the element’s qualified name (MDN). In HTML it is usually the lowercase tag (e.g. "div").
Read the notes below before you get or set this property. Prefer feature detection when support is limited.
Use el.localName. Start with this line.
element.localName| Call | What it does |
|---|---|
element.localName | Primary signature. |
Built into the browser. Read or assign el.localName — no import required.
element.localName| Parameter | Description |
|---|---|
| Namespace props | Optional. prefix, namespaceURI for XML/SVG |
| Return Value | Description |
|---|---|
| * | String (local part) |
localNameRead the local name of a normal HTML element.
const box = document.getElementById("box");
console.log(box.localName);
// "div"getElementById("box") returns a <div>.localName. You get the local name string."div" (lowercase).localName vs tagNameIn HTML DOMs, tagName is uppercase while localName is lowercase.
const el = document.querySelector("button");
console.log(el.localName); // "button"
console.log(el.tagName); // "BUTTON"
console.log(el.localName === "button"); // true
console.log(el.tagName === "button"); // falselocalName is lowercase for HTML elements in HTML documents.tagName is uppercase for those same HTML elements.localName === "button" (or uppercase tagName on purpose).localNameCreate an SVG circle and read its local name (and namespace).
const NS = "http://www.w3.org/2000/svg";
const circle = document.createElementNS(NS, "circle");
console.log(circle.localName); // "circle"
console.log(circle.namespaceURI); // "http://www.w3.org/2000/svg"createElementNS builds a real SVG element."circle". That is the part after any prefix in a qualified name.namespaceURI tells you which vocabulary it belongs to.svg:circle, the local name is still "circle".Element.localName is Baseline Widely available (MDN: since July 2015). Safe across modern and older evergreen browsers.
Read-only local part of the element's qualified name — lowercase for HTML in HTML DOMs.
Bottom line: Safe for production. Prefer localName for case-stable HTML tag checks.
Learn how to read the namespace URI of an element.
12 people found this page helpful