Blame view

node_modules/@babel/code-frame/README.md 2.77 KB
ce4c83ff   wxy   初始提交
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
  # @babel/code-frame
  
  > Generate errors that contain a code frame that point to source locations.
  
  ## Install
  
  ```sh
  npm install --save-dev @babel/code-frame
  ```
  
  ## Usage
  
  ```js
  import { codeFrameColumns } from '@babel/code-frame';
  
  const rawLines = `class Foo {
    constructor()
  }`;
  const location = { start: { line: 2, column: 16 } };
  
  const result = codeFrameColumns(rawLines, location, { /* options */ });
  
  console.log(result);
  ```
  
  ```
    1 | class Foo {
  > 2 |   constructor()
      |                ^
    3 | }
  ```
  
  If the column number is not known, you may omit it.
  
  You can also pass an `end` hash in `location`.
  
  ```js
  import { codeFrameColumns } from '@babel/code-frame';
  
  const rawLines = `class Foo {
    constructor() {
      console.log("hello");
    }
  }`;
  const location = { start: { line: 2, column: 17 }, end: { line: 4, column: 3 } };
  
  const result = codeFrameColumns(rawLines, location, { /* options */ });
  
  console.log(result);
  ```
  
  ```
    1 | class Foo {
  > 2 |   constructor() {
      |                 ^
  > 3 |     console.log("hello");
      | ^^^^^^^^^^^^^^^^^^^^^^^^^
  > 4 |   }
      | ^^^
    5 | };
  ```
  
  ## Options
  
  ### `highlightCode`
  
  `boolean`, defaults to `false`.
  
  Toggles syntax highlighting the code as JavaScript for terminals.
  
  
  ### `linesAbove`
  
  `number`, defaults to `2`.
  
  Adjust the number of lines to show above the error.
  
  ### `linesBelow`
  
  `number`, defaults to `3`.
  
  Adjust the number of lines to show below the error.
  
  ### `forceColor`
  
  `boolean`, defaults to `false`.
  
  Enable this to forcibly syntax highlight the code as JavaScript (for non-terminals); overrides `highlightCode`.
  
  ### `message`
  
  `string`, otherwise nothing
  
  Pass in a string to be displayed inline (if possible) next to the highlighted
  location in the code. If it can't be positioned inline, it will be placed above
  the code frame.
  
  ```
  1 | class Foo {
  > 2 |   constructor()
    |                ^ Missing {
  3 | };
  ```
  
  ## Upgrading from prior versions
  
  Prior to version 7, the only API exposed by this module was for a single line and optional column pointer. The old API will now log a deprecation warning.
  
  The new API takes a `location` object, similar to what is available in an AST.
  
  This is an example of the deprecated (but still available) API:
  
  ```js
  import codeFrame from '@babel/code-frame';
  
  const rawLines = `class Foo {
    constructor()
  }`;
  const lineNumber = 2;
  const colNumber = 16;
  
  const result = codeFrame(rawLines, lineNumber, colNumber, { /* options */ });
  
  console.log(result);
  ```
  
  To get the same highlighting using the new API:
  
  ```js
  import { codeFrameColumns } from '@babel/code-frame';
  
  const rawLines = `class Foo {
    constructor() {
      console.log("hello");
    }
  }`;
  const location = { start: { line: 2, column: 16 } };
  
  const result = codeFrameColumns(rawLines, location, { /* options */ });
  
  console.log(result);
  ```