ZVON > References > DOM2 Reference

insertRow (method )

Owning interface and usage:  
HTMLTableElement.insertRow(index)

Member of these other interfaces:  
none

Description:  
Insert a new empty row in the table. The new row is inserted immediately before and in the same section as the current indexth row in the table. If index is -1 or equal to the number of rows, the new row is appended. In addition, when the table is empty the row is inserted into a TBODY which is created and inserted into the table.

Parameters:  
long index  -  The row number where to insert a new row. This index starts from 0 and is relative to the logical order (not document order) of all the rows contained inside the table.

Returns:  
HTMLElement -  The newly created row.

Exceptions:  
DOMException INDEX_SIZE_ERR
Raised if the specified index is greater than the number of rows or if the index is a negative number other than -1.

Note:  
A table row cannot be empty according to [HTML40] .