Skip to main content

isElement()

isElement(value): value is Element

Checks if value is a DOM element.

DEPRECATED

Use instanceof Element directly instead.

Parameters​

value: unknown​

The value to check.

Returns: value is Element​

true if value is a DOM element, else false.

See Also​

Element - MDN

Since​

2.0.0

Also known as​

isElement (Lodash, es-toolkit) · ❌ (Remeda, Radashi, Ramda, Effect, Modern Dash, Antfu)

Example​

// ❌ Deprecated approach
isElement(document.body);           // => true
isElement('<body>');                // => false

// ✅ Recommended approach
document.body instanceof Element;   // => true
'<body>' instanceof Element;        // => false

How it works?​

Checks if value is a DOM element. Deprecated: Use instanceof Element directly.

Native Equivalent​

// ❌ isElement(value)
// ✅ value instanceof Element

Use Cases​

Check DOM element 📌​

Check if value is a DOM element.

value instanceof Element;
// or
value instanceof HTMLElement;

Validate before DOM ops​

Ensure value is an element before manipulation.

if (target instanceof Element) {
  target.classList.add("active");
}

Type guard​

Narrow type for TypeScript.

const isElement = (v: unknown): v is Element => 
  v instanceof Element;