HTMLTableElement: createTHead()

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

table.createTHead();

Return value

HTMLTableSectionElement

Example

let myhead = mytable.createTHead();
// Now this should be true: myhead == mytable.tHead

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'HTMLTableElement: createTHead' in that specification.
Living Standard

Browser compatibility

BCD tables only load in the browser