Skip to content

In docs remove Object as a data type for send#2077

Merged
lpinca merged 1 commit intowebsockets:masterfrom
DLiblik:dliblik-fix-docs
Sep 18, 2022
Merged

In docs remove Object as a data type for send#2077
lpinca merged 1 commit intowebsockets:masterfrom
DLiblik:dliblik-fix-docs

Conversation

@DLiblik
Copy link
Copy Markdown
Contributor

@DLiblik DLiblik commented Sep 18, 2022

websocket.send does not support a plain old Object of any shape and throws a TypeError.

This fixes the docs to remove Object as a supported type for the data parameter

Addresses #2076

@lpinca
Copy link
Copy Markdown
Member

lpinca commented Sep 18, 2022

See #2076 (comment).

Comment thread doc/ws.md Outdated
- `data` {Array|Number|Object|String|ArrayBuffer|Buffer|DataView|TypedArray} The
data to send. For Object values, the passed-in item will be serialized through
node's own
[Buffer.from()](https://nodejs.org/api/buffer.html#static-method-bufferfromobject-offsetorencoding-length)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[Buffer.from()](https://nodejs.org/api/buffer.html#static-method-bufferfromobject-offsetorencoding-length)
[`Buffer.from()`](https://nodejs.org/api/buffer.html#static-method-bufferfromobject-offsetorencoding-length)

Also, for consistency can you please move the link to the bottom?

Comment thread doc/ws.md Outdated
node's own
[Buffer.from()](https://nodejs.org/api/buffer.html#static-method-bufferfromobject-offsetorencoding-length)
function, which defines additional constraints. If those constraints are not
met, a TypeError will occur.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
met, a TypeError will occur.
met, a `TypeError` will occur.

Add reference to Node.js's own related documentation about the
constraints on `Object` values.
@lpinca lpinca merged commit c22cbc9 into websockets:master Sep 18, 2022
@lpinca
Copy link
Copy Markdown
Member

lpinca commented Sep 18, 2022

Thank you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants