HTMLTableElement: tHead property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

The tHead property of the HTMLTableElement interface represents the first <thead> element child of the given <table>, or null if no such element exists.

Value

An HTMLTableSectionElement (which is always a thead) or null.

This property can be assigned, which causes the existing first <thead> element child, if any, to be removed, and the given value, if it is not null, to be inserted immediately before the first element child that's neither a <caption> nor a <colgroup>, or as the last child if there is no such element. Therefore, setting null has the same effect as calling deleteTHead(). If the assigned value is not an HTMLTableSectionElement or null, a TypeError is thrown; otherwise, if it is not a <thead> element or null, a HierarchyRequestError DOMException is thrown.

Examples

js
if (table.tHead) {
  // Do something with the thead
}

Specifications

Specification
HTML
# dom-table-thead-dev

Browser compatibility

See also