third_party/WebKit/Source/core/dom/URL.idl

   1 /*
   2  * Copyright (C) 2011 Google Inc. All rights reserved.
   3  * Copyright (C) 2012 Motorola Mobility Inc.
   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  *
   9  * 1.  Redistributions of source code must retain the above copyright
  10  *     notice, this list of conditions and the following disclaimer.
  11  * 2.  Redistributions in binary form must reproduce the above copyright
  12  *     notice, this list of conditions and the following disclaimer in the
  13  *     documentation and/or other materials provided with the distribution.
  14  *
  15  * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
  16  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  17  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  18  * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
  19  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  20  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  21  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  22  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25  */
  26
  27 // https://url.spec.whatwg.org/#url
  28
  29 [
  30     // TODO(philipj): There should only be one constructor:
  31     // Constructor(USVString url, optional USVString base)
  32     Constructor(USVString url),
  33     Constructor(USVString url, USVString base),
  34     Constructor(USVString url, URL base),
  35     Exposed=(Window,Worker),
  36     ImplementedAs=DOMURL,
  37     RaisesException=Constructor,
  38     GarbageCollected,
  39 ] interface URL {
  40     // TODO(philipj): Implement domainToASCII() and domainToUnicode().
  41     // crbug.com/493908
  42     // static USVString domainToASCII(USVString domain);
  43     // static USVString domainToUnicode(USVString domain);
  44
  45     // TODO(philipj): This should be in a partial interface definition:
  46     // File API
  47     // https://w3c.github.io/FileAPI/#creating-revoking
  48     // TODO(philipj): Neither the return value nor the argument should be nullable.
  49     [RaisesException, CallWith=ExecutionContext] static DOMString? createObjectURL(Blob? blob);
  50     [CallWith=ExecutionContext] static void revokeObjectURL(DOMString url);
  51 };
  52
  53 URL implements URLUtils;