add key path param

[maa-dar]

add key path to parameters sent to compare and replacer as this info is sometimes very crutial.

Why?

Often one would like to customize the printing of json based on where the json is in the tree like for example take:

{
  users: [
    {id:5. name: 'john', familyName: 'doe'}, ...
  ],
  asset: [
    {id:5, family: 'tools', name: 'hammer' }, ...
  ]
}

so here the family of the asset i want it before the name while in the user i want the family name to be before. (Note this is a theoratical example just to better explain my point)

[ljharb]

Can you elaborate on the use case here?

Either way it'd need documentation and tests.

[ljharb]

using this syntax would be a breaking change.

[maa-dar]

Suggested change

	return (function stringify(parent, key, node, path = []) {
	return (function stringify(parent, key, node, path = []) {
	path = typeof(path) === 'number' ? new Array(path) : path;

[ljharb]

the breaking syntax is default parameters - = in a function signature.

[maa-dar]

cool then

Suggested change

	return (function stringify(parent, key, node, path = []) {
	return (function stringify(parent, key, node, path = []) {
	path = typeof(path) === 'number' ? new Array(path) : (path == null ? [] : path);

[ljharb]

again, it's the path = [] in the signature that can't work.