third_party/WebKit/Source/core/html/HTMLAllCollection.idl

   1 /*
   2  * Copyright (C) 2009 Apple Inc. All rights reserved.
   3  * Copyright (C) 2014 Samsung Electronics. All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
  15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
  18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  22  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25  */
  26
  27 // https://html.spec.whatwg.org/#the-htmlallcollection-interface
  28
  29 // FIXME: This interface should inherit HTMLCollection.
  30 [
  31     Custom=LegacyCallAsFunction,
  32     DependentLifetime,
  33     SetWrapperReferenceFrom=ownerNode,
  34     WillBeGarbageCollected,
  35 ] interface HTMLAllCollection {
  36     // FIXME: length and 'getter' should be inherited from HTMLCollection.
  37     readonly attribute unsigned long length;
  38     [ImplementedAs=item] getter Element (unsigned long index);
  39     // FIXME: The custom item() implementation may return a NodeList, but the
  40     // spec has a (HTMLCollection or Element)? item(DOMString name) method.
  41     [Custom] Element? item([Default=Undefined] optional unsigned long index);
  42     // FIXME:
  43     // FIXME: namedItem() should be a legacycaller. crbug.com/465009
  44     // FIXME: namedItem() should return an (HTMLCollection or Element)? union.
  45     [ImplementedAs=namedGetter] getter (NodeList or Element)? namedItem(DOMString name);
  46 };