# wild-wild-parser > 🀠 Parser for object property paths with wildcards and regexps 🌡 Latest version **5.0.1** (published 2025-03-29) Β· Apache-2.0 license Β· 0 weekly downloads ## Install ```sh npm install wild-wild-parser pnpm add wild-wild-parser yarn add wild-wild-parser bun add wild-wild-parser ``` ## Health **Score 55/100 (C)** β€” status: stable. Positive: has types; esm support; no vulnerabilities; high maintenance score; high quality score. Warnings: low downloads. Negative: stale. ## Facts | | | |---|---| | Version | 5.0.1 | | Published | 2025-03-29 | | First published | 2022-03-25 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Node | >=18.18.0 | | Dependencies | 0 | | Unpacked size | 43.8 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 16 | | Author | ehmicky | | Maintainers | ehmicky | | Keywords | wildcard, glob, globbing, globstar, regex, regexp, regular-expression, path, recursion, functional-programming, map, filter, algorithm, data-structures, javascript, json, library, nodejs, parsing, typescript | ## Links - npm: https://www.npmjs.com/package/wild-wild-parser - Repository: https://github.com/ehmicky/wild-wild-parser - Homepage: https://www.github.com/ehmicky/wild-wild-parser - Issues: https://github.com/ehmicky/wild-wild-parser/issues - npm.io page: https://npm.io/package/wild-wild-parser ## Alternatives - [@mapbox/jsonlint-lines-primitives](https://npm.io/package/@mapbox/jsonlint-lines-primitives.md) β€” 5.3M weekly downloads - [reftools](https://npm.io/package/reftools.md) β€” 3.5M weekly downloads - [@hey-api/openapi-ts](https://npm.io/package/@hey-api/openapi-ts.md) β€” 3.5M weekly downloads - [@mapbox/geojson-rewind](https://npm.io/package/@mapbox/geojson-rewind.md) β€” 2.4M weekly downloads - [turbo-stream](https://npm.io/package/turbo-stream.md) β€” 1.7M weekly downloads ## Recent versions - 5.0.1 (latest) β€” 2025-03-29 - 5.0.0 β€” 2023-10-28 - 4.0.0 β€” 2023-05-14 - 3.4.0 β€” 2022-11-11 - 3.3.0 β€” 2022-11-07 - 3.2.0 β€” 2022-10-08 - 3.1.0 β€” 2022-08-16 - 3.0.1 β€” 2022-07-18 - 3.0.0 β€” 2022-05-09 - 2.3.0 β€” 2022-04-06 - 2.2.0 β€” 2022-04-05 - 2.1.0 β€” 2022-04-05 - 2.0.0 β€” 2022-04-04 - 1.1.0 β€” 2022-04-02 - 1.0.1 β€” 2022-04-01 - … 1 more at https://npm.io/package/wild-wild-parser/versions ## README wild-wild-parser logo [![Node](https://img.shields.io/badge/-Node.js-808080?logo=node.js&colorA=404040&logoColor=66cc33)](https://www.npmjs.com/package/wild-wild-parser) [![Browsers](https://img.shields.io/badge/-Browsers-808080?logo=firefox&colorA=404040)](https://unpkg.com/wild-wild-parser?module) [![TypeScript](https://img.shields.io/badge/-Typed-808080?logo=typescript&colorA=404040&logoColor=0096ff)](/src/main.d.ts) [![Codecov](https://img.shields.io/badge/-Tested%20100%25-808080?logo=codecov&colorA=404040)](https://codecov.io/gh/ehmicky/wild-wild-parser) [![Minified size](https://img.shields.io/bundlephobia/minzip/wild-wild-parser?label&colorA=404040&colorB=808080&logo=webpack)](https://bundlephobia.com/package/wild-wild-parser) [![Mastodon](https://img.shields.io/badge/-Mastodon-808080.svg?logo=mastodon&colorA=404040&logoColor=9590F9)](https://fosstodon.org/@ehmicky) [![Medium](https://img.shields.io/badge/-Medium-808080.svg?logo=medium&colorA=404040)](https://medium.com/@ehmicky) 🀠 Parser for object property paths with wildcards and regexps. 🌡 [`wild-wild-path`](https://github.com/ehmicky/wild-wild-path) is a library which gets/sets object properties using [dot-delimited paths](https://github.com/ehmicky/wild-wild-path#%EF%B8%8F-deep-properties), [wildcards](https://github.com/ehmicky/wild-wild-path#-wildcards), [regexps](https://github.com/ehmicky/wild-wild-path#%EF%B8%8F-regexps), [slices](https://github.com/ehmicky/wild-wild-path#%EF%B8%8F-array-slices) and [unions](https://github.com/ehmicky/wild-wild-path#-unions). `wild-wild-parser` allows manipulating [its query format](https://github.com/ehmicky/wild-wild-path#queries): - πŸš‚ [Parse](#parsequeryquerystring)/[serialize](#serializequeryqueryarray), i.e. convert between [query strings](https://github.com/ehmicky/wild-wild-path#query-strings) and [query arrays](https://github.com/ehmicky/wild-wild-path#query-arrays) - ⭐ [Normalize](#normalizequeryquery) queries - πŸ—ΊοΈ [Compare](#issamequeryfirstquery-secondquery) queries # Install ```bash npm install wild-wild-parser ``` This package works in both Node.js >=18.18.0 and [browsers](https://raw.githubusercontent.com/ehmicky/dev-tasks/main/src/browserslist). This is an ES module. It must be loaded using [an `import` or `import()` statement](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c), not `require()`. If TypeScript is used, it must be configured to [output ES modules](https://www.typescriptlang.org/docs/handbook/esm-node.html), not CommonJS. # API ## parseQuery(queryString) `queryString` [`QueryString`](https://github.com/ehmicky/wild-wild-path#query-strings)\ _Return value_: [`QueryArray`](https://github.com/ehmicky/wild-wild-path#query-arrays) Convert a [query string](https://github.com/ehmicky/wild-wild-path#query-strings) into a [query array](https://github.com/ehmicky/wild-wild-path#query-arrays). ```js parseQuery('users.0.*') // [['users', 0, { type: 'any' }]] parseQuery('users admins') // [['users'], ['admins']] parseQuery('users./[/') // Throws: invalid RegExp ``` ## serializeQuery(queryArray) `queryArray` [`QueryArray`](https://github.com/ehmicky/wild-wild-path#query-arrays)\ _Return value_: [`QueryString`](https://github.com/ehmicky/wild-wild-path#query-strings) Convert a [query array](https://github.com/ehmicky/wild-wild-path#query-arrays) into a [query string](https://github.com/ehmicky/wild-wild-path#query-strings). ```js serializeQuery(['users', 0, { type: 'any' }]) // 'users.0.*' serializeQuery([['users'], ['admins']]) // 'users admins' serializeQuery([true]) // Throws: `true` is not a valid query ``` ## normalizeQuery(query) `query` [`Query`](https://github.com/ehmicky/wild-wild-path#queries)\ _Return value_: [`QueryArray`](https://github.com/ehmicky/wild-wild-path#query-arrays) If the query is a [query string](https://github.com/ehmicky/wild-wild-path#query-strings), convert it into a [query array](https://github.com/ehmicky/wild-wild-path#query-arrays). If it is already a query array, normalize it to a canonical form. ```js normalizeQuery('users.0.*') // [['users', 0, { type: 'any' }]] normalizeQuery(['users']) // [['users']] normalizeQuery([['users'], ['admins']]) // [['users'], ['admins']] normalizeQuery([{ type: 'slice' }]) // [[{ type: 'slice', from: 0 }]] normalizeQuery('users./[/') // Throws: invalid RegExp normalizeQuery([true]) // Throws: `true` is not a valid query ``` ## parsePath(pathString) `pathString` [`PathString`](https://github.com/ehmicky/wild-wild-path#paths)\ _Return value_: [`PathArray`](https://github.com/ehmicky/wild-wild-path#paths) Same as [`parseQuery()`](#parsequeryquerystring) but only for a [path query](https://github.com/ehmicky/wild-wild-path#paths). ```js parsePath('users.0') // ['users', 0] parsePath('*') // Throws: this is a valid query but not a path parsePath('users./[/') // Throws: invalid RegExp ``` ## serializePath(pathArray) `pathArray` [`PathArray`](https://github.com/ehmicky/wild-wild-path#paths)\ _Return value_: [`PathString`](https://github.com/ehmicky/wild-wild-path#paths) Same as [`serializeQuery()`](#serializequeryqueryarray) but only for a [path query](https://github.com/ehmicky/wild-wild-path#paths). ```js serializePath(['users', 0]) // 'users.0' serializePath([{ type: 'any' }]) // Throws: this is a valid query but not a path serializePath([true]) // Throws: `true` is not a valid query ``` ## normalizePath(path) `path` [`Path`](https://github.com/ehmicky/wild-wild-path#paths)\ _Return value_: [`PathArray`](https://github.com/ehmicky/wild-wild-path#paths) Same as [`normalizeQuery()`](#normalizequeryquery) but only for a [path query](https://github.com/ehmicky/wild-wild-path#paths). ```js normalizePath('users.0') // ['users', 0] normalizePath(['users', 0]) // ['users', 0] normalizePath('*') // Throws: `*` is a valid query but not a path normalizePath([true]) // Throws: `true` is not a valid query ``` ## isSameQuery(firstQuery, secondQuery) `firstQuery` [`Query`](https://github.com/ehmicky/wild-wild-path#queries)\ `secondQuery` [`Query`](https://github.com/ehmicky/wild-wild-path#queries)\ _Return value_: `boolean` Return `true` if both queries are the same, even if they use different formats ([string](https://github.com/ehmicky/wild-wild-path#query-strings) or [array](https://github.com/ehmicky/wild-wild-path#query-arrays)) or if they are syntactically different but semantically identical. ```js isSameQuery('users.0.*', 'users.0.*') // true isSameQuery('users.0.*', ['users', 0, { type: 'any' }]) // true isSameQuery(['users', 0, { type: 'any' }], ['users', 0, { type: 'any' }]) // true isSameQuery('users.0.*', 'users.1.*') // false isSameQuery('0:2', ':2') // true isSameQuery([['user']], ['user']) // true isSameQuery([true], 'user') // Throws: `true` is not a valid query ``` ## isSamePath(firstPath, secondPath) `firstPath` [`Path`](https://github.com/ehmicky/wild-wild-path#paths)\ `secondPath` [`Path`](https://github.com/ehmicky/wild-wild-path#paths)\ _Return value_: `boolean` Same as [`isSameQuery()`](#issamepathfirstpath-secondpath) but only for a [path query](https://github.com/ehmicky/wild-wild-path#paths). ```js isSamePath('user.name', 'user.name') // true isSamePath('user.name', ['user', 'name']) // true isSamePath(['user', 'name'], ['user', 'name']) // true isSamePath('user.name', 'user.lastName') // false isSamePath('*', 'user.name') // Throws: `*` is a valid query but not a path isSamePath([true], 'user.name') // Throws: `true` is not a valid query ``` ## isParentPath(parentPath, childPath) `parentPath` [`Path`](https://github.com/ehmicky/wild-wild-path#paths)\ `childPath` [`Path`](https://github.com/ehmicky/wild-wild-path#paths)\ _Return value_: `boolean` Return `true` if the first argument is a parent path to the second. Queries that are not [paths](https://github.com/ehmicky/wild-wild-path#paths) cannot be used. ```js isParentPath('user', 'user.name') // true isParentPath('user', 'user.settings.name') // true isParentPath('user', ['user', 'settings', 'name']) // true isParentPath(['user'], ['user', 'settings', 'name']) // true isParentPath('user', 'user') // false isParentPath('user.name', 'user') // false isParentPath('user.name', 'user.settings') // false isParentPath('*', 'user.name') // Throws: `*` is valid query but not a path isParentPath([true], 'user.name') // Throws: `true` is not a valid query ``` ## isSameToken(firstToken, secondToken) `firstToken` [`Token`](https://github.com/ehmicky/wild-wild-path#query-arrays)\ `secondToken` [`Token`](https://github.com/ehmicky/wild-wild-path#query-arrays)\ _Return value_: `boolean` Same as [`isSameQuery()`](#issamepathfirstpath-secondpath) but only for [query array](https://github.com/ehmicky/wild-wild-path#query-arrays) individual tokens. ```js isSameToken('user', 'user') // true isSameToken('user', 'users') // false isSameToken(2, 2) // true isSameToken(0, -0) // false isSameToken(/Name/, /Name/) // true isSameToken(/Name/, /name/i) // false isSameToken({ type: 'slice' }, { type: 'slice', from: 0 }) // true isSameToken('user', true) // Throws: invalid token `true` ``` ## getTokenType(token) `token` [`Token`](https://github.com/ehmicky/wild-wild-path#query-arrays)\ _Return value_: `string` Retrieve the type of a [query array](https://github.com/ehmicky/wild-wild-path#query-arrays) individual token among: `"prop"`, `"index"`, `"slice"`, `"regExp"`, `"any"` or `"anyDeep"`. `"unknown"` is returned if the token is invalid. ```js getTokenType('user') // "prop" getTokenType(0) // "index" getTokenType(/Name/) // "regExp" getTokenType({ type: 'slice', from: 0, to: 2 }) // "slice" getTokenType({ type: 'any' }) // "any" getTokenType({ type: 'anyDeep' }) // "anyDeep" getTokenType(true) // "unknown" ``` # Related projects - [`wild-wild-path`](https://github.com/ehmicky/wild-wild-path): get/set object properties using `wild-wild-parser`'s paths - [`wild-wild-utils`](https://github.com/ehmicky/wild-wild-utils): functional utilities using `wild-wild-parser`'s paths # Support For any question, _don't hesitate_ to [submit an issue on GitHub](../../issues). Everyone is welcome regardless of personal background. We enforce a [Code of conduct](CODE_OF_CONDUCT.md) in order to promote a positive and inclusive environment. # Contributing This project was made with ❀️. The simplest way to give back is by starring and sharing it online. If the documentation is unclear or has a typo, please click on the page's `Edit` button (pencil icon) and suggest a correction. If you would like to help us fix a bug or add a new feature, please check our [guidelines](CONTRIBUTING.md). Pull requests are welcome! --- _Source: https://npm.io/package/wild-wild-parser Β· Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._