main
Last change
on this file was d565449, checked in by stefan toskovski <stefantoska84@…>, 4 weeks ago |
Update repo after prototype presentation
|
-
Property mode
set to
100644
|
File size:
1.9 KB
|
Line | |
---|
1 | # strip-json-comments [![Build Status](https://travis-ci.com/sindresorhus/strip-json-comments.svg?branch=master)](https://travis-ci.com/github/sindresorhus/strip-json-comments)
|
---|
2 |
|
---|
3 | > Strip comments from JSON. Lets you use comments in your JSON files!
|
---|
4 |
|
---|
5 | This is now possible:
|
---|
6 |
|
---|
7 | ```js
|
---|
8 | {
|
---|
9 | // Rainbows
|
---|
10 | "unicorn": /* ❤ */ "cake"
|
---|
11 | }
|
---|
12 | ```
|
---|
13 |
|
---|
14 | It will replace single-line comments `//` and multi-line comments `/**/` with whitespace. This allows JSON error positions to remain as close as possible to the original source.
|
---|
15 |
|
---|
16 | Also available as a [Gulp](https://github.com/sindresorhus/gulp-strip-json-comments)/[Grunt](https://github.com/sindresorhus/grunt-strip-json-comments)/[Broccoli](https://github.com/sindresorhus/broccoli-strip-json-comments) plugin.
|
---|
17 |
|
---|
18 | ## Install
|
---|
19 |
|
---|
20 | ```
|
---|
21 | $ npm install strip-json-comments
|
---|
22 | ```
|
---|
23 |
|
---|
24 | ## Usage
|
---|
25 |
|
---|
26 | ```js
|
---|
27 | const json = `{
|
---|
28 | // Rainbows
|
---|
29 | "unicorn": /* ❤ */ "cake"
|
---|
30 | }`;
|
---|
31 |
|
---|
32 | JSON.parse(stripJsonComments(json));
|
---|
33 | //=> {unicorn: 'cake'}
|
---|
34 | ```
|
---|
35 |
|
---|
36 | ## API
|
---|
37 |
|
---|
38 | ### stripJsonComments(jsonString, options?)
|
---|
39 |
|
---|
40 | #### jsonString
|
---|
41 |
|
---|
42 | Type: `string`
|
---|
43 |
|
---|
44 | Accepts a string with JSON and returns a string without comments.
|
---|
45 |
|
---|
46 | #### options
|
---|
47 |
|
---|
48 | Type: `object`
|
---|
49 |
|
---|
50 | ##### whitespace
|
---|
51 |
|
---|
52 | Type: `boolean`\
|
---|
53 | Default: `true`
|
---|
54 |
|
---|
55 | Replace comments with whitespace instead of stripping them entirely.
|
---|
56 |
|
---|
57 | ## Benchmark
|
---|
58 |
|
---|
59 | ```
|
---|
60 | $ npm run bench
|
---|
61 | ```
|
---|
62 |
|
---|
63 | ## Related
|
---|
64 |
|
---|
65 | - [strip-json-comments-cli](https://github.com/sindresorhus/strip-json-comments-cli) - CLI for this module
|
---|
66 | - [strip-css-comments](https://github.com/sindresorhus/strip-css-comments) - Strip comments from CSS
|
---|
67 |
|
---|
68 | ---
|
---|
69 |
|
---|
70 | <div align="center">
|
---|
71 | <b>
|
---|
72 | <a href="https://tidelift.com/subscription/pkg/npm-strip-json-comments?utm_source=npm-strip-json-comments&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
|
---|
73 | </b>
|
---|
74 | <br>
|
---|
75 | <sub>
|
---|
76 | Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
|
---|
77 | </sub>
|
---|
78 | </div>
|
---|
Note:
See
TracBrowser
for help on using the repository browser.