GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing github.com — tools,doc: parse types in braces everywhere · nodejs/node@c893cd3

File tree

Expand file treeCollapse file tree

Open diff view settings

Filter options

doc/api
- errors.markdown
tools/doc
- html.js
- type-parser.js

Expand file treeCollapse file tree

Open diff view settings

Collapse file

`‎doc/api/errors.markdown‎`

Copy file name to clipboardExpand all lines: doc/api/errors.markdown

+10-19Lines changed: 10 additions & 19 deletions

Display the source diff
Display the rich diff

Original file line number	Diff line number	Diff line change
`@@ -6,13 +6,13 @@ Applications running in Node.js will generally experience four categories of`
`6`	`6`	`errors:`
`7`	`7`
`8`	`8`	`- Standard JavaScript errors such as:`
`9`		- - [`EvalError`][]: thrown when a call to `eval()` fails.
`10`		- - [`SyntaxError`][]: thrown in response to improper JavaScript language
	`9`	+ - {EvalError} : thrown when a call to `eval()` fails.
	`10`	`+ - {SyntaxError} : thrown in response to improper JavaScript language`
`11`	`11`	`syntax.`
`12`		- - [`RangeError`][]: thrown when a value is not within an expected range
`13`		- - [`ReferenceError`][]: thrown when using undefined variables
`14`		- - [`TypeError`][]: thrown when passing arguments of the wrong type
`15`		- - [`URIError`][]: thrown when a global URI handling function is misused.
	`12`	`+ - {RangeError} : thrown when a value is not within an expected range`
	`13`	`+ - {ReferenceError} : thrown when using undefined variables`
	`14`	`+ - {TypeError} : thrown when passing arguments of the wrong type`
	`15`	`+ - {URIError} : thrown when a global URI handling function is misused.`
`16`	`16`	`- System errors triggered by underlying operating system constraints such`
`17`	`17`	`as attempting to open a file that does not exist, attempting to send data`
`18`	`18`	`over a closed socket, etc;`
`@@ -22,7 +22,7 @@ errors:`
`22`	`22`	are raised typically by the `assert` module.
`23`	`23`
`24`	`24`	`All JavaScript and System errors raised by Node.js inherit from, or are`
`25`		-instances of, the standard JavaScript [`Error`][] class and are guaranteed
	`25`	`+instances of, the standard JavaScript {Error} class and are guaranteed`
`26`	`26`	`to provide at least the properties available on that class.`
`27`	`27`
`28`	`28`	`## Error Propagation and Interception`
`@@ -36,7 +36,7 @@ called.`
`36`	`36`
`37`	`37`	`All JavaScript errors are handled as exceptions that immediately generate`
`38`	`38`	and throw an error using the standard JavaScript `throw` mechanism. These
`39`		-are handled using the [`try / catch` construct][] provided by the JavaScript
	`39`	+are handled using the [`try / catch` construct][try-catch] provided by the JavaScript
`40`	`40`	`language.`
`41`	`41`
`42`	`42`	```js
`@@ -105,7 +105,7 @@ pass or fail).`
`105`	`105`
`106`	`106`	For all `EventEmitter` objects, if an `'error'` event handler is not
`107`	`107`	`provided, the error will be thrown, causing the Node.js process to report an`
`108`		-unhandled exception and crash unless either: The [`domain`][] module is used
	`108`	+unhandled exception and crash unless either: The [`domain`][domains] module is used
`109`	`109`	`appropriately or a handler has been registered for the`
`110`	`110`	[`process.on('uncaughtException')`][] event.
`111`	`111`
`@@ -520,9 +520,6 @@ found [here][online].`
`520`	`520`	encountered by [`http`][] or [`net`][] -- often a sign that a `socket.end()`
`521`	`521`	`was not properly called.`
`522`	`522`
`523`		-[`domain`]: domain.html
`524`		-[`EvalError`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError
`525`		-[`Error`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error
`526`	`523`	[`fs.readdir`]: fs.html#fs_fs_readdir_path_callback
`527`	`524`	[`fs.readFileSync`]: fs.html#fs_fs_readfilesync_file_options
`528`	`525`	[`fs.unlink`]: fs.html#fs_fs_unlink_path_callback
`@@ -531,18 +528,12 @@ found [here][online].`
`531`	`528`	[`https`]: https.html
`532`	`529`	[`net`]: net.html
`533`	`530`	[`process.on('uncaughtException')`]: process.html#process_event_uncaughtexception
`534`		-[`try / catch` construct]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch
`535`		-[`try { } catch(err) { }`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch
`536`	`531`	`[domains]: domain.html`
`537`	`532`	`[event emitter-based]: events.html#events_class_events_eventemitter`
`538`	`533`	`[file descriptors]: https://en.wikipedia.org/wiki/File_descriptor`
`539`	`534`	`[online]: http://man7.org/linux/man-pages/man3/errno.3.html`
`540`	`535`	`[stream-based]: stream.html`
`541`	`536`	`[syscall]: http://man7.org/linux/man-pages/man2/syscall.2.html`
	`537`	`+[try-catch]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch`
`542`	`538`	`[V8's stack trace API]: https://github.com/v8/v8/wiki/Stack-Trace-API`
`543`	`539`	`[vm]: vm.html`
`544`		-[`SyntaxError`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError
`545`		-[`RangeError`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError
`546`		-[`ReferenceError`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError
`547`		-[`TypeError`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError
`548`		-[`URIError`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/URIError

Collapse file

`‎tools/doc/html.js‎`

Copy file name to clipboardExpand all lines: tools/doc/html.js

+2-4Lines changed: 2 additions & 4 deletions

Original file line number	Diff line number	Diff line change
`@@ -112,6 +112,7 @@ function parseText(lexed) {`
`112`	`112`	`lexed.forEach(function(tok) {`
`113`	`113`	`if (tok.text && tok.type !== 'code') {`
`114`	`114`	`tok.text = linkManPages(tok.text);`
	`115`	`+ tok.text = linkJsTypeDocs(tok.text);`
`115`	`116`	`}`
`116`	`117`	`});`
`117`	`118`	`}`
`@@ -166,9 +167,6 @@ function parseLists(input) {`
`166`	`167`	`}`
`167`	`168`	`return;`
`168`	`169`	`}`
`169`		`- if (tok.text) {`
`170`		`- tok.text = parseListItem(tok.text);`
`171`		`- }`
`172`	`170`	`}`
`173`	`171`	`output.push(tok);`
`174`	`172`	`});`
`@@ -197,7 +195,7 @@ function linkManPages(text) {`
`197`	`195`	`});`
`198`	`196`	`}`
`199`	`197`
`200`		`-function parseListItem(text) {`
	`198`	`+function linkJsTypeDocs(text) {`
`201`	`199`	var parts = text.split('`');
`202`	`200`	`var i;`
`203`	`201`	`var typeMatches;`

Collapse file

`‎tools/doc/type-parser.js‎`

Copy file name to clipboardExpand all lines: tools/doc/type-parser.js

+2-1Lines changed: 2 additions & 1 deletion

Original file line number	Diff line number	Diff line change
`@@ -11,7 +11,8 @@ const jsGlobalTypes = [`
`11`	`11`	`'Error', 'Object', 'Function', 'Array', 'Uint8Array',`
`12`	`12`	`'Uint16Array', 'Uint32Array', 'Int8Array', 'Int16Array', 'Int32Array',`
`13`	`13`	`'Uint8ClampedArray', 'Float32Array', 'Float64Array', 'Date', 'RegExp',`
`14`		`- 'ArrayBuffer', 'DataView', 'Promise'`
	`14`	`+ 'ArrayBuffer', 'DataView', 'Promise', 'EvalError', 'RangeError',`
	`15`	`+ 'ReferenceError', 'SyntaxError', 'TypeError', 'URIError'`
`15`	`16`	`];`
`16`	`17`	`const typeMap = {`
`17`	`18`	`'Buffer': 'buffer.html#buffer_class_buffer',`

0 commit comments

Comments

0 (0)

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.