summaryrefslogtreecommitdiffstats
path: root/devtools/shared/storage/vendor/JSON5_UPGRADING.md
blob: 631d73ee460005334d94602b6d7f3115bbab78c0 (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
[//]: # (
  This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
)

# Upgrading json5

## Getting the Source

```bash
git clone https://github.com/json5/json5
cd json5
git checkout v2.2.1 # checkout the right version tag
```

## Building

```bash
npm install
npm run build
cp dist/index.js <gecko-dev>/devtools/shared/storage/vendor/json5.js
```

## Patching json5

- open `json5.js`
- Add the version number to the top of the file:
  ```
  /**
   * json5 v2.2.1
   */
  ```
- Replace instances of `Function('return this')()` with `globalThis`. See Bug 1473549.

## Update the version:

The current version is 2.2.1. Update this version number everywhere in this file.