OLD | NEW |
1 /* | 1 /* |
2 * Copyright (C) 2008 Apple Inc. All rights reserved. | 2 * Copyright (C) 2008 Apple Inc. All rights reserved. |
3 * | 3 * |
4 * Redistribution and use in source and binary forms, with or without | 4 * Redistribution and use in source and binary forms, with or without |
5 * modification, are permitted provided that the following conditions | 5 * modification, are permitted provided that the following conditions |
6 * are met: | 6 * are met: |
7 * | 7 * |
8 * 1. Redistributions of source code must retain the above copyright | 8 * 1. Redistributions of source code must retain the above copyright |
9 * notice, this list of conditions and the following disclaimer. | 9 * notice, this list of conditions and the following disclaimer. |
10 * 2. Redistributions in binary form must reproduce the above copyright | 10 * 2. Redistributions in binary form must reproduce the above copyright |
11 * notice, this list of conditions and the following disclaimer in the | 11 * notice, this list of conditions and the following disclaimer in the |
12 * documentation and/or other materials provided with the distribution. | 12 * documentation and/or other materials provided with the distribution. |
13 * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of | 13 * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of |
14 * its contributors may be used to endorse or promote products derived | 14 * its contributors may be used to endorse or promote products derived |
15 * from this software without specific prior written permission. | 15 * from this software without specific prior written permission. |
16 * | 16 * |
17 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY | 17 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY |
18 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED | 18 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED |
19 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | 19 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
20 * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY | 20 * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY |
21 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | 21 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES |
22 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | 22 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; |
23 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | 23 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND |
24 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | 24 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | 25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
27 */ | 27 */ |
28 | 28 |
| 29 // https://html.spec.whatwg.org/#the-location-interface |
| 30 |
29 [ | 31 [ |
30 CheckSecurity=Frame, | 32 CheckSecurity=Frame, |
| 33 Unforgeable, |
31 WillBeGarbageCollected, | 34 WillBeGarbageCollected, |
32 ] interface Location { | 35 ] interface Location { |
33 // |assign|, |replace|, and *writing* |href| do not require a security | 36 // |assign|, |replace|, and *writing* |href| do not require a security |
34 // check, as they *change* the page, and thus these do not change any | 37 // check, as they *change* the page, and thus these do not change any |
35 // property of an *existing* document at a different origin. | 38 // property of an *existing* document at a different origin. |
36 // However, *reading* |href|, or accessing any component, is a security | 39 // However, *reading* |href|, or accessing any component, is a security |
37 // problem, since that allows tracking navigation. | 40 // problem, since that allows tracking navigation. |
38 [SetterCallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity=Setter, Unfor
geable, DartCustom=Setter] attribute DOMString href; | 41 [CallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity] void assign(DOMStr
ing url); |
| 42 [CallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity] void replace(DOMSt
ring url); |
| 43 [CallWith=ActiveWindow] void reload(); |
39 | 44 |
40 [CallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity, Unforgeable, DartC
ustom] void assign(DOMString url); | 45 // TODO(philipj): ancestorOrigins should have [SameObject] and be of type |
41 [CallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity, Unforgeable, DartC
ustom] void replace(DOMString url); | 46 // DOMString[], i.e. it should return the same array every time. |
42 [CallWith=ActiveWindow, Unforgeable, DartCustom] void reload(); | 47 [Measure] readonly attribute DOMStringList ancestorOrigins; |
43 | 48 |
44 // URI decomposition attributes | 49 // TODO(philipj): Per spec, Location implements URLUtils. The below is |
45 [SetterCallWith=(ActiveWindow,FirstWindow), RaisesException=Setter, DartCust
om=Setter] attribute DOMString protocol; | 50 // mostly like the URLUtils interface, but with some members missing and |
46 [SetterCallWith=(ActiveWindow,FirstWindow), DartCustom=Setter] attribute DOM
String host; | 51 // using DOMString instead of USVString. |
47 [SetterCallWith=(ActiveWindow,FirstWindow), DartCustom=Setter] attribute DOM
String hostname; | 52 [SetterCallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity=Setter] attri
bute DOMString href; |
48 [SetterCallWith=(ActiveWindow,FirstWindow), DartCustom=Setter] attribute DOM
String port; | 53 [NotEnumerable, ImplementedAs=href] DOMString toString(); |
49 [SetterCallWith=(ActiveWindow,FirstWindow), DartCustom=Setter] attribute DOM
String pathname; | |
50 [SetterCallWith=(ActiveWindow,FirstWindow), DartCustom=Setter] attribute DOM
String search; | |
51 [SetterCallWith=(ActiveWindow,FirstWindow), DartCustom=Setter] attribute DOM
String hash; | |
52 | |
53 readonly attribute DOMString origin; | 54 readonly attribute DOMString origin; |
54 | 55 |
55 readonly attribute DOMStringList ancestorOrigins; | 56 [SetterCallWith=(ActiveWindow,FirstWindow), RaisesException=Setter] attribut
e DOMString protocol; |
| 57 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString host; |
| 58 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString hostname; |
| 59 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString port; |
| 60 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString pathname; |
| 61 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString search; |
| 62 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString hash; |
56 | 63 |
57 [NotEnumerable, Unforgeable, ImplementedAs=href] DOMString toString(); | 64 // TODO(philipj): Location does not have a valueOf() override in the spec. |
58 [NotEnumerable, Custom, Unforgeable] any valueOf(); | 65 // See the comment in Location.h for the purpose of this. |
| 66 [NotEnumerable, CallWith=ThisValue] any valueOf(); |
59 }; | 67 }; |
60 | |
OLD | NEW |