dom/webidl/Location.webidl

   1 /* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* This Source Code Form is subject to the terms of the Mozilla Public
   3  * License, v. 2.0. If a copy of the MPL was not distributed with this file,
   4  * You can obtain one at http://mozilla.org/MPL/2.0/.
   5  *
   6  * The origin of this IDL file is
   7  * http://www.whatwg.org/specs/web-apps/current-work/#the-location-interface
   8  *
   9  * © Copyright 2004-2011 Apple Computer, Inc., Mozilla Foundation, and
  10  * Opera Software ASA. You are granted a license to use, reproduce
  11  * and create derivative works of this document.
  12  */
  13
  14 [Unforgeable]
  15 interface Location {
  16   // Bug 824857: no support for stringifier attributes yet.
  17   //  stringifier attribute USVString href;
  18
  19   // Bug 824857 should remove this.
  20   [Throws, NeedsSubjectPrincipal]
  21   stringifier;
  22
  23   [Throws, CrossOriginWritable, NeedsSubjectPrincipal]
  24            attribute USVString href;
  25   [Throws, NeedsSubjectPrincipal]
  26   readonly attribute USVString origin;
  27   [Throws, NeedsSubjectPrincipal]
  28            attribute USVString protocol;
  29   [Throws, NeedsSubjectPrincipal]
  30            attribute USVString host;
  31   [Throws, NeedsSubjectPrincipal]
  32            attribute USVString hostname;
  33   [Throws, NeedsSubjectPrincipal]
  34            attribute USVString port;
  35   [Throws, NeedsSubjectPrincipal]
  36            attribute USVString pathname;
  37   [Throws, NeedsSubjectPrincipal]
  38            attribute USVString search;
  39   [Throws, NeedsSubjectPrincipal]
  40            attribute USVString hash;
  41
  42   [Throws, NeedsSubjectPrincipal]
  43   void assign(USVString url);
  44
  45   [Throws, CrossOriginCallable, NeedsSubjectPrincipal]
  46   void replace(USVString url);
  47
  48   // XXXbz there is no forceget argument in the spec!  See bug 1037721.
  49   [Throws, NeedsSubjectPrincipal]
  50   void reload(optional boolean forceget = false);
  51
  52   // Bug 1085214 [SameObject] readonly attribute USVString[] ancestorOrigins;
  53 };