summaryrefslogtreecommitdiff
path: root/data/extensions/jsr@javascriptrestrictor/wrappingS-HTML.js
blob: 9893381dac674bd2f22a50820a905d48e0506c97 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
/** \file
 * \brief This file contains wrapper that clears the window.name property
 *
 * \see https://developer.mozilla.org/en-US/docs/Web/API/Window/name
 *
 *  \author Copyright (C) 2020  Martin Bednar, Libor Polcak
 *
 *  \license SPDX-License-Identifier: GPL-3.0-or-later
 */
//
//  This program is free software: you can redistribute it and/or modify
//  it under the terms of the GNU General Public License as published by
//  the Free Software Foundation, either version 3 of the License, or
//  (at your option) any later version.
//
//  This program is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//  GNU General Public License for more details.
//
//  You should have received a copy of the GNU General Public License
//  along with this program.  If not, see <https://www.gnu.org/licenses/>.
//

/** \file
 * \ingroup wrappers
 *
 * `window.name` provides a simple cross-origin tracking method of the same tab:
 *
 * ```js
 * window.name = "8pdRoEaQCpsjtC8w07dOy7xwXjXrHDyxxmPWBUxQKrh7xfJ4SYFH8QClp6U9T+Ypa8IEa5AwFw3x"
 * ```
 *
 * Go to completely different web site and window.name stays the same.
 *
 * \see https://2019.www.torproject.org/projects/torbrowser/design/ provides a library build on
 * top of `window.name`: https://www.thomasfrank.se/sessionvars.html.
 *
 * \see https://html.spec.whatwg.org/#history-traversal; this feature should not be ncessary
 * for Firefox 86 or newer https://bugzilla.mozilla.org/show_bug.cgi?id=444222.
 */

/*
 * Create private namespace
 */
(function() {
	var wrappers = [
		{
			parent_object: "window",
			parent_object_property: "name",
			wrapped_objects: [],
			helping_code: "/* window.name = ''; */", // we actually do this  in level_cache.js on eTLD+1 domain changes
		},
	]
	add_wrappers(wrappers);
})()