HTMLTableElement: createTHead() method

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 createTHead() method of HTMLTableElement objects returns the <thead> element associated with a given <table>. If no header exists in the table, this method creates it, and then returns it.

Note: If no header exists, createTHead() inserts a new header directly into the table. The header does not need to be added separately as would be the case if Document.createElement() had been used to create the new <thead> element.

Syntax

js
createTHead()

Parameters

None.

Return value

HTMLTableSectionElement

Examples

js
let myHead = myTable.createTHead();
// Now this should be true: myHead === myTable.tHead

Specifications

Specification
HTML Standard
# dom-table-createthead-dev

Browser compatibility

BCD tables only load in the browser