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, |
31 Unforgeable, | 33 Unforgeable, |
32 WillBeGarbageCollected, | 34 WillBeGarbageCollected, |
33 ] interface Location { | 35 ] interface Location { |
34 // |assign|, |replace|, and *writing* |href| do not require a security | 36 // |assign|, |replace|, and *writing* |href| do not require a security |
35 // 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 |
36 // property of an *existing* document at a different origin. | 38 // property of an *existing* document at a different origin. |
37 // However, *reading* |href|, or accessing any component, is a security | 39 // However, *reading* |href|, or accessing any component, is a security |
38 // problem, since that allows tracking navigation. | 40 // problem, since that allows tracking navigation. |
39 [SetterCallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity=Setter] attri
bute DOMString href; | |
40 | |
41 [CallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity] void assign(DOMStr
ing url); | 41 [CallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity] void assign(DOMStr
ing url); |
42 [CallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity] void replace(DOMSt
ring url); | 42 [CallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity] void replace(DOMSt
ring url); |
43 [CallWith=ActiveWindow] void reload(); | 43 [CallWith=ActiveWindow] void reload(); |
44 | 44 |
45 // URI decomposition attributes | 45 // TODO(philipj): ancestorOrigins should have [SameObject] and be of type |
| 46 // DOMString[], i.e. it should return the same array every time. |
| 47 [Measure] readonly attribute DOMStringList ancestorOrigins; |
| 48 |
| 49 // TODO(philipj): Per spec, Location implements URLUtils. The below is |
| 50 // mostly like the URLUtils interface, but with some members missing and |
| 51 // using DOMString instead of USVString. |
| 52 [SetterCallWith=(ActiveWindow,FirstWindow), DoNotCheckSecurity=Setter] attri
bute DOMString href; |
| 53 [NotEnumerable, ImplementedAs=href] DOMString toString(); |
| 54 readonly attribute DOMString origin; |
| 55 |
46 [SetterCallWith=(ActiveWindow,FirstWindow), RaisesException=Setter] attribut
e DOMString protocol; | 56 [SetterCallWith=(ActiveWindow,FirstWindow), RaisesException=Setter] attribut
e DOMString protocol; |
47 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString host; | 57 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString host; |
48 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString hostname; | 58 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString hostname; |
49 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString port; | 59 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString port; |
50 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString pathname; | 60 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString pathname; |
51 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString search; | 61 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString search; |
52 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString hash; | 62 [SetterCallWith=(ActiveWindow,FirstWindow)] attribute DOMString hash; |
53 | 63 |
54 readonly attribute DOMString origin; | 64 // TODO(philipj): Location does not have a valueOf() override in the spec. |
55 | 65 // See the comment in Location.h for the purpose of this. |
56 [Measure] readonly attribute DOMStringList ancestorOrigins; | |
57 | |
58 [NotEnumerable, ImplementedAs=href] DOMString toString(); | |
59 [NotEnumerable, CallWith=ThisValue] any valueOf(); | 66 [NotEnumerable, CallWith=ThisValue] any valueOf(); |
60 }; | 67 }; |
OLD | NEW |