mirror of https://github.com/nodejs/node.git
doc: add note for binary safe string reading
`readable.setEncoding(null)` - may be the most preferable way to proxy a binary data without any encoding/decoding overhead PR-URL: https://github.com/nodejs/node/pull/5155 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Roman Reiss <me@silverwind.io>pull/5155/merge
parent
40d57b714e
commit
8d8fef09ee
|
@ -416,6 +416,10 @@ potentially mangled if you simply pulled the Buffers directly and
|
||||||
called [`buf.toString(encoding)`][] on them. If you want to read the data
|
called [`buf.toString(encoding)`][] on them. If you want to read the data
|
||||||
as strings, always use this method.
|
as strings, always use this method.
|
||||||
|
|
||||||
|
Also you can disable any encoding at all with `readable.setEncoding(null)`.
|
||||||
|
This approach is very useful if you deal with binary data or with large
|
||||||
|
multi-byte strings spread out over multiple chunks.
|
||||||
|
|
||||||
```js
|
```js
|
||||||
var readable = getReadableStreamSomehow();
|
var readable = getReadableStreamSomehow();
|
||||||
readable.setEncoding('utf8');
|
readable.setEncoding('utf8');
|
||||||
|
|
Loading…
Reference in New Issue