Sync HTML element interfaces S-V with the spec

Source/core/html/HTMLTableElement.idl

 /*
  * Copyright (C) 2006, 2007, 2010 Apple Inc. All rights reserved.
  * Copyright (C) 2006 Samuel Weinig <sam.weinig@gmail.com>
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public
  * License as published by the Free Software Foundation; either
  * version 2 of the License, or (at your option) any later version.
  *
  * This library is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  * Library General Public License for more details.
  *
  * You should have received a copy of the GNU Library General Public License
  * along with this library; see the file COPYING.LIB.  If not, write to
  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
 
+// https://html.spec.whatwg.org/#the-table-element
+
 interface HTMLTableElement : HTMLElement {
-    [RaisesException=Setter] attribute HTMLTableCaptionElement caption;
-    [RaisesException=Setter] attribute HTMLTableSectionElement tHead;
-    [RaisesException=Setter] attribute HTMLTableSectionElement tFoot;
+    // TODO(philipj): The caption, tHead and tFoot setters should never throw.
+    [RaisesException=Setter] attribute HTMLTableCaptionElement? caption;
+    HTMLElement createCaption();
+    void deleteCaption();
+    [RaisesException=Setter] attribute HTMLTableSectionElement? tHead;
+    HTMLElement createTHead();
+    void deleteTHead();
+    [RaisesException=Setter] attribute HTMLTableSectionElement? tFoot;
+    HTMLElement createTFoot();
+    void deleteTFoot();
+    readonly attribute HTMLCollection tBodies;
+    HTMLElement createTBody();
+    readonly attribute HTMLCollection rows;
+    [RaisesException] HTMLElement insertRow(optional long index = -1);
+    // TODO(philipj): The index argument should not be optional.
+    [RaisesException] void deleteRow([Default=Undefined] optional long index);
+    // attribute boolean sortable;
+    // void stopSorting();
 
-    readonly attribute HTMLCollection rows;
-    readonly attribute HTMLCollection tBodies;
+    // obsolete members
+    // https://html.spec.whatwg.org/#HTMLTableElement-partial
     [Reflect] attribute DOMString align;
-    [Reflect, TreatNullAs=EmptyString] attribute DOMString bgColor;
     [Reflect] attribute DOMString border;
-    [Reflect, TreatNullAs=EmptyString] attribute DOMString cellPadding;
-    [Reflect, TreatNullAs=EmptyString] attribute DOMString cellSpacing;
-
     [Reflect] attribute DOMString frame;
-
     [Reflect] attribute DOMString rules;
     [Reflect] attribute DOMString summary;
     [Reflect] attribute DOMString width;
 
-    HTMLElement createTHead();
-    void deleteTHead();
-    HTMLElement createTFoot();
-    void deleteTFoot();
-    HTMLElement createTBody();
-    HTMLElement createCaption();
-    void deleteCaption();
-
-    [RaisesException] HTMLElement insertRow(optional long index = -1);
-    [RaisesException] void deleteRow([Default=Undefined] optional long index);
+    [Reflect, TreatNullAs=EmptyString] attribute DOMString bgColor;
+    [Reflect, TreatNullAs=EmptyString] attribute DOMString cellPadding;
+    [Reflect, TreatNullAs=EmptyString] attribute DOMString cellSpacing;
 };