HTMLTableElement.createCaption()

The HTMLTableElement.createCaption() method returns the <caption> element associated with a given <table>. If no <caption> element exists on the table, this method creates it, and then returns it.

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

Syntax

createCaption()

Return value

HTMLTableCaptionElement

Examples

This example uses JavaScript to add a caption to a table that initially lacks one.

HTML

<table>
  <tr><td>Cell 1.1</td><td>Cell 1.2</td><td>Cell 1.3</td></tr>
  <tr><td>Cell 2.1</td><td>Cell 2.2</td><td>Cell 2.3</td></tr>
</table>

JavaScript

let table = document.querySelector('table');
let caption = table.createCaption();
caption.textContent = 'This caption was created by JavaScript!';

Result

Specifications

Specification
HTML Standard # dom-table-createcaption-dev

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`createCaption`	1	12	1	5.5	≤12.1	3	1	18	4	≤12.1	1	1.0

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableElement/createCaption

Name	Web APIs
Version
Badge
Last Updated	2022-04-27T09:33:08Z