Skip to content

docs: add info about serializable types for querystring.stringify() #12313

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
shubheksha wants to merge 3 commits into from
Closed

docs: add info about serializable types for querystring.stringify() #12313

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
3ed323f
docs: add info about serializable types
shubheksha Apr 10, 2017
31fca1c
doc: add info about other data types
shubheksha Apr 10, 2017
fec24ec
doc: uses {} to link to mdn docs for types
shubheksha Apr 11, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
doc: add info about other data types 
Fix typo.
Add what happens when another data type is passed to `querystring.stringify()` besides the ones that can be correctly parsed
  • Loading branch information
@shubheksha
shubheksha committed Apr 10, 2017
commit 31fca1cb0d66d164cee24b12d0a5c7aa8da5fe59
3 changes: 2 additions & 1 deletion doc/api/querystring.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -101,8 +101,9 @@ added: v0.1.25
The `querystring.stringify()` method produces a URL query string from a
given `obj` by iterating through the object's "own properties".

This method searializes the following types of values passed in `obj`: strings,
This method serializes the following types of values passed in `obj`: strings,

@joyeecheung joyeecheung Apr 11, 2017 •
edited by TimothyGu
Loading

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.

Maybe this paragragh can be added to the type annotation of obj above? Using the {Type} syntax would give us links to MDN documentations. Something like

Values should be {String|Number|Boolean|String[]|Number[]|Boolean[]}
(more explanations)

@jasnell jasnell Apr 11, 2017

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.

Feel free to ignore, but I would just drop the This method at the front :-)

@shubheksha shubheksha Apr 11, 2017

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@joyeecheung, this is neat -- I didn't know this!
@jasnell, dropped :)

finite numbers, booleans and arrays of the aforementioned types.
Any other input values will be coerced to empty strings

@hiroppy hiroppy Apr 10, 2017 •
edited
Loading

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.

I think that it is better to use the period(I'm sorry if I'm wrong because I am not native).

@shubheksha shubheksha Apr 11, 2017

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

You're right, thanks for pointing it out :)


For example:

Expand Down