From ab4a98ed669c08b12e76b8a5ce1b97b9b1634f86 Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Mon, 21 Nov 2016 20:46:49 -0800 Subject: [PATCH] doc: clarify slashes-appending in url module PR-URL: https://github.com/nodejs/node/pull/9731 Ref: https://github.com/nodejs/node/issues/9521 Reviewed-By: Luigi Pinca --- doc/api/url.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/doc/api/url.md b/doc/api/url.md index 6d573b4b910f27..40a3440195e69a 100644 --- a/doc/api/url.md +++ b/doc/api/url.md @@ -154,10 +154,11 @@ The formatting process operates as follows: [`Error`][] is thrown. * For all string values of `urlObject.protocol` that *do not end* with an ASCII colon (`:`) character, the literal string `:` will be appended to `result`. -* If either the `urlObject.slashes` property is true, `urlObject.protocol` - begins with one of `http`, `https`, `ftp`, `gopher`, or `file`, or - `urlObject.protocol` is `undefined`, the literal string `//` will be appended - to `result`. +* If either of the following conditions is true, then the literal string `//` + will be appended to `result`: + * `urlObject.slashes` property is true; + * `urlObject.protocol` begins with `http`, `https`, `ftp`, `gopher`, or + `file`; * If the value of the `urlObject.auth` property is truthy, and either `urlObject.host` or `urlObject.hostname` are not `undefined`, the value of `urlObject.auth` will be coerced into a string and appended to `result`