Skip to content
/ xcase Public

Blazingly fast recursive conversion to and from camelCase or PascalCase for objects and arrays and strings

License

Notifications You must be signed in to change notification settings

encharm/xcase

Repository files navigation

xcase

Blazingly fast recursive conversion to and from camelCase or PascalCase for objects and arrays and strings.

It supports both Node.js and Browser.

xcase passes most of https://github.com/domchristie/humps tests, excluding only those with custom regexps and handler functions. So if you use humps and need something much faster than this is the right place.

> node benchmark.js
xcase#camelize x 7,521,530 ops/sec ±0.18% (96 runs sampled)
humps#camelize x 870,637 ops/sec ±0.67% (95 runs sampled)
lodash#camelCase x 784,445 ops/sec ±1.18% (92 runs sampled)
Fastest is xcase#camelize
xcase#decamelize x 6,517,893 ops/sec ±0.43% (94 runs sampled)
humps#decamelize x 1,576,663 ops/sec ±0.65% (95 runs sampled)
lodash#snakeCase x 659,930 ops/sec ±1.50% (95 runs sampled)
Fastest is xcase#decamelize
xcase#camelizeKeys x 642,111 ops/sec ±1.16% (92 runs sampled)
humps#camelizeKeys x 126,551 ops/sec ±0.64% (91 runs sampled)
lodash#reduce + camelCase x 120,886 ops/sec ±1.11% (92 runs sampled)
Fastest is xcase#camelizeKeys
xcase#decamelizeKeys x 613,896 ops/sec ±1.13% (86 runs sampled)
humps#decamelizeKeys x 194,091 ops/sec ±0.61% (92 runs sampled)
lodash#reduce + snakeCase: 
Fastest is xcase#decamelizeKeys
xcase#camelizeKeys (large object) x 678 ops/sec ±0.35% (94 runs sampled)
xcase#camelizeKeys {inPlace: true} (large object) x 570 ops/sec ±1.41% (86 runs sampled)
humps#camelizeKeys (large object) x 163 ops/sec ±0.22% (82 runs sampled)
Fastest is xcase#camelizeKeys (large object)
xcase#decamelizeKeys (large object) x 665 ops/sec ±0.68% (92 runs sampled)
humps#decamelizeKeys (large object) x 238 ops/sec ±0.63% (85 runs sampled)
Fastest is xcase#decamelizeKeys (large object)

Installation

Node: npm install --save xcase

Browser (JSPM): jspm install npm:xcase

Browser (Bower): jspm install xcase

Browser (Manual): Load https://raw.githubusercontent.com/encharm/xcase/master/dist/xcase.min.js and use global xcase object

Usage:

let {camelizeKeys} = require('xcase');
let obj = camelizeKeys({
  foo_bar: 1
}); 
// obj is {fooBar: 1}

API

  • camelize(string, [options])

    change "foo_bar"/"foo bar"/"foo-bar" to "fooBar"

  • camelizeKeys(objectOrArray, [options])

    change all keys according to camelize

  • decamelize(string, [options])

    change "fooBar" to "foo_bar" and takes custom separator in options

  • decamelizeKeys(objectOrArray, [options])

    change all keys according to decamelize

  • pascalize(string, [opts])

    change "foo_bar"/"foo bar"/"foo-bar" to "FooBar"

  • pascalizeKeys(objectOrArray, [options])

    change all keys according to pascalize

  • depascalize(string, [opts])

    change "FooBar" to "foo_bar" and takes custom separator in options

  • depascalizeKeys(objectOrArray, [options])

    change all keys according to depascalize

Options:

  • inPlace: true - to modify existing object (note, it's slower than default! v8 is smarter than us)
  • separator - for example - for de** variant of functions

License

MIT

Copyright (c) 2016, Code Charm Ltd

About

Blazingly fast recursive conversion to and from camelCase or PascalCase for objects and arrays and strings

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published