summaryrefslogtreecommitdiff
path: root/data/extensions/jsr@javascriptrestrictor/wrapping.js
blob: 94b2c7afd44a9ca452c77e305f126c88639bf46b (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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
/** \file
 * \brief Main file handling wrappers
 *
 *  \author Copyright (C) 2019  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/>.
//

/**
 * \defgroup wrappers JavaScript Shield
 *
 * \brief Wrappers are small pieces of code that modifies the original functionalty of a function,
 * or property defined by standards.
 *
 * $(PROJECT_NAME) defines wrappers to modify the behaviour of the JavaScript environment. The
 * purpose of the most of the wrappers can be divided into several categories:
 *
 * * Block APIs: some APIs are not generally needed and can be blocked for most of the pages.
 * * Precision reduction: The returned value is too precise which might result into attacks on the
 * browser or can be used to fingerprint users.
 * * Hide information: Some APIs provide information that is not generally needed and can be hidden
 * from most of the pages.
 * * Provide fake information: We provide fake information mostly to confuse fingerprinters.
 */

/**
 * The object carrying all the wrappers
 */
var build_wrapping_code = {};

/**
 * Adds a list of wrapping objects to the build_wrapping_code.
 *
 * This function is called from each wrapper in its file.
 */
function add_wrappers(wrappers) {
	for (wrapper of wrappers) {
		build_wrapping_code[wrapper.parent_object + "." + wrapper.parent_object_property] = wrapper;
	}
}

/**
 * Function to be used by wrapped code used for rounding
 */
var rounding_function = `function rounding_function(numberToRound, precision) {
	return numberToRound - (numberToRound % precision);
}`;

/**
 * Function to be used by wrapped code for adding randomized noise
 */
var noise_function = `let lastValue = 0;
	function noise_function(numberToChange, precision) {
    const noise = Math.floor(Math.random() * precision);
    var value = numberToChange + noise;
    if (lastValue < value) {
        lastValue = value;
    }
    return lastValue;
}`;