Skip to content

Commit

Permalink
doc: response body in http module
Browse files Browse the repository at this point in the history
Fixes: #8057
  • Loading branch information
minervapanda committed Oct 9, 2016
1 parent 90cd39f commit f2bcdea
Show file tree
Hide file tree
Showing 2 changed files with 16 additions and 0 deletions.
3 changes: 3 additions & 0 deletions doc/api/http.md
Original file line number Diff line number Diff line change
Expand Up @@ -1015,6 +1015,9 @@ it will switch to implicit header mode and flush the implicit headers.
This sends a chunk of the response body. This method may
be called multiple times to provide successive parts of the body.

Note that in `http` module, the response body is omitted when the request is a
HEAD. Similarly, The `204` and `304` responses MUST NOT include a message body.

`chunk` can be a string or a buffer. If `chunk` is a string,
the second parameter specifies how to encode it into a byte stream.
By default the `encoding` is `'utf8'`. `callback` will be called when this chunk
Expand Down
13 changes: 13 additions & 0 deletions doc/api/url.md
Original file line number Diff line number Diff line change
Expand Up @@ -235,6 +235,19 @@ url.resolve('http://example.com/', '/one') // 'http://example.com/one'
url.resolve('http://example.com/one', '/two') // 'http://example.com/two'
```

Note that `url.resolve()` method depends on the protocol given in the `from` parameter.
Some protocols like `https`, `file`, `ftp`, `wss` and `gopher` have special cases.

For example:

```js
url.resolve('https://foo.tld', 'bar') // 'https://foo.tld/bar'
url.resolve('wss://foo.tld', 'bar') // 'wss://bar'
url.resolve('ftps://foo.tld', 'bar') // 'ftps://bar'
```

Although, the uniform behaviour of the method is achieved when the URL ends with a slash.

## Escaped Characters

URLs are only permitted to contain a certain range of characters. Spaces (`' '`)
Expand Down

0 comments on commit f2bcdea

Please sign in to comment.