@@ -2232,7 +2232,7 @@ Emitted when the buffer of the message is free again. |
2232 | 2232 | added: v0.1.17 |
2233 | 2233 | --> |
2234 | 2234 |
|
2235 | | -Emitted when transmission is finished successfully. |
| 2235 | +Emitted when the transmission is finished successfully. |
2236 | 2236 |
|
2237 | 2237 | ### Event: `prefinish` |
2238 | 2238 | <!-- YAML |
@@ -2253,9 +2253,9 @@ added: v0.3.0 |
2253 | 2253 | Adds HTTP trailers (headers but at the end of the message) to the message. |
2254 | 2254 |
|
2255 | 2255 | Trailers are **only** be emitted if the message is chunked encoded. If not, |
2256 | | -trailer will be silently discarded. |
| 2256 | +the trailer will be silently discarded. |
2257 | 2257 |
|
2258 | | -HTTP requires the `Trailer` header to be sent in order to emit trailers, |
| 2258 | +HTTP requires the `Trailer` header to be sent to emit trailers, |
2259 | 2259 | with a list of header fields in its value, e.g. |
2260 | 2260 |
|
2261 | 2261 | ```js |
@@ -2344,8 +2344,8 @@ added: v0.4.0 |
2344 | 2344 | * `name` {string} Name of header |
2345 | 2345 | * Returns {string | undefined} |
2346 | 2346 |
|
2347 | | -Gets value of HTTP header with given name. If such name doesn't exist in |
2348 | | -message, it will be `undefined`. |
| 2347 | +Gets the value of HTTP header with the given name. If such a name doesn't |
| 2348 | +exist in message, it will be `undefined`. |
2349 | 2349 |
|
2350 | 2350 | ### `outgoingMessage.getHeaderNames()` |
2351 | 2351 | <!-- YAML |
@@ -2366,7 +2366,7 @@ added: v8.0.0 |
2366 | 2366 |
|
2367 | 2367 | Returns a shallow copy of the current outgoing headers. Since a shallow |
2368 | 2368 | copy is used, array values may be mutated without additional calls to |
2369 | | -various header-related http module methods. The keys of the returned |
| 2369 | +various header-related HTTP module methods. The keys of the returned |
2370 | 2370 | object are the header names and the values are the respective header |
2371 | 2371 | values. All header names are lowercase. |
2372 | 2372 |
|
@@ -2419,7 +2419,7 @@ Since `OutgoingMessage` should be a write-only stream, |
2419 | 2419 | call this function will throw an `Error`. Thus, it disabled the pipe method |
2420 | 2420 | it inherits from `Stream`. |
2421 | 2421 |
|
2422 | | -User should not call this function directly. |
| 2422 | +The User should not call this function directly. |
2423 | 2423 |
|
2424 | 2424 | ### `outgoingMessage.removeHeader()` |
2425 | 2425 | <!-- YAML |
@@ -2441,7 +2441,7 @@ added: v0.4.0 |
2441 | 2441 | * `value` {string} Header value |
2442 | 2442 | * Returns: {this} |
2443 | 2443 |
|
2444 | | -Sets a single header value for header object. |
| 2444 | +Sets a single header value for the header object. |
2445 | 2445 |
|
2446 | 2446 | ### `outgoingMessage.setTimeout(msesc[, callback])` |
2447 | 2447 | <!-- YAML |
@@ -2463,7 +2463,7 @@ added: v0.3.0 |
2463 | 2463 |
|
2464 | 2464 | * {stream.Duplex} |
2465 | 2465 |
|
2466 | | -Reference to the underlying socket. Usually users will not want to access |
| 2466 | +Reference to the underlying socket. Usually, users will not want to access |
2467 | 2467 | this property. |
2468 | 2468 |
|
2469 | 2469 | After calling `outgoingMessage.end()`, this property will be nulled. |
@@ -2516,8 +2516,8 @@ This `outgoingMessage.writableHighWaterMark` will be the `highWaterMark` of |
2516 | 2516 | underlying socket if socket exists. Else, it would be the default |
2517 | 2517 | `highWaterMark`. |
2518 | 2518 |
|
2519 | | -`highWaterMark` is the maximum amount of data which can be potentially |
2520 | | -buffered by socket. |
| 2519 | +`highWaterMark` is the maximum amount of data that can be potentially |
| 2520 | +buffered by the socket. |
2521 | 2521 |
|
2522 | 2522 | ### `outgoingMessage.writableLength` |
2523 | 2523 | <!-- YAML |
@@ -2551,11 +2551,11 @@ changes: |
2551 | 2551 | * `callback` {Function} |
2552 | 2552 | * Returns {boolean} |
2553 | 2553 |
|
2554 | | -If this method is called and header is not sent, it will call |
| 2554 | +If this method is called and the header is not sent, it will call |
2555 | 2555 | `this._implicitHeader` to flush implicit header. |
2556 | 2556 | If the message should not have a body (indicated by `this._hasBody`), |
2557 | 2557 | the call is ignored and `chunk` will not be sent. It could be useful |
2558 | | -when handling particular message which must not include a body. |
| 2558 | +when handling a particular message which must not include a body. |
2559 | 2559 | e.g. response to `HEAD` request, `204` and `304` response. |
2560 | 2560 |
|
2561 | 2561 | `chunk` can be a string or a buffer. When `chunk` is a string, the |
@@ -2564,21 +2564,21 @@ e.g. response to `HEAD` request, `204` and `304` response. |
2564 | 2564 |
|
2565 | 2565 | If the message is transferred in chucked encoding |
2566 | 2566 | (indicated by `this.chunkedEncoding`), `chunk` will be flushed as |
2567 | | -one chunk among a stream of chunks. Otherwise, it will be flushed as body |
2568 | | -of message. |
| 2567 | +one chunk among a stream of chunks. Otherwise, it will be flushed as the |
| 2568 | +body of message. |
2569 | 2569 |
|
2570 | | -This method handles the raw body of HTTP message and has nothing to do with |
2571 | | -higher-level multi-part body encodings that may be used. |
| 2570 | +This method handles the raw body of the HTTP message and has nothing to do |
| 2571 | +with higher-level multi-part body encodings that may be used. |
2572 | 2572 |
|
2573 | 2573 | If it is the first call to this method of a message, it will send the |
2574 | 2574 | buffered header first, then flush the the `chunk` as described above. |
2575 | 2575 |
|
2576 | | -The second and successive calls to this method, it will assume the data |
2577 | | -will streamed and send the new data separately. It means that the response |
| 2576 | +The second and successive calls to this method will assume the data |
| 2577 | +will be streamed and send the new data separately. It means that the response |
2578 | 2578 | is buffered up to the first chunk of the body. |
2579 | 2579 |
|
2580 | 2580 | Returns `true` if the entire data was flushed successfully to the kernel |
2581 | | -buffer. Returns `false` if all or part of the data was queued in user |
| 2581 | +buffer. Returns `false` if all or part of the data was queued in the user |
2582 | 2582 | memory. Event `drain` will be emitted when the buffer is free again. |
2583 | 2583 |
|
2584 | 2584 | ## `http.METHODS` |
|