Change Case

Transform a string between camelCase, PascalCase, Capital Case, snake_case, kebab-case, CONSTANT_CASE and others.

Installation

npm install change-case --save

Usage

import * as changeCase from "change-case";

changeCase.camelCase("TEST_VALUE"); //=> "testValue"

Included case functions:

Method	Result
`camelCase`	`twoWords`
`capitalCase`	`Two Words`
`constantCase`	`TWO_WORDS`
`dotCase`	`two.words`
`kebabCase`	`two-words`
`noCase`	`two words`
`pascalCase`	`TwoWords`
`pascalSnakeCase`	`Two_Words`
`pathCase`	`two/words`
`sentenceCase`	`Two words`
`snakeCase`	`two_words`
`trainCase`	`Two-Words`

All methods accept an options object as the second argument:

delimiter?: string The character to use between words. Default depends on method, e.g. _ in snake case.
locale?: string[] | string | false Lower/upper according to specified locale, defaults to host environment. Set to false to disable.
split?: (value: string) => string[] A function to define how the input is split into words. Defaults to split.
prefixCharacters?: string Retain at the beginning of the string. Defaults to "". Example: use "_" to keep the underscores in __typename.
suffixCharacters?: string Retain at the end of the string. Defaults to "". Example: use "_" to keep the underscore in type_.

By default, pascalCase and snakeCase separate ambiguous characters with _. For example, V1.2 would become V1_2 instead of V12. If you prefer them merged you can set mergeAmbiguousCharacters to true.

Split

Change case exports a split utility which can be used to build other case functions. It accepts a string and returns each "word" as an array. For example:

split("fooBar")
  .map((x) => x.toLowerCase())
  .join("_"); //=> "foo_bar"

Change Case Keys

import * as changeKeys from "change-case/keys";

changeKeys.camelCase({ TEST_KEY: true }); //=> { testKey: true }

Change case keys wraps around the core methods to transform object keys to any case.

API

input: any Any JavaScript value.
depth: number Specify the depth to transfer for case transformation. Defaults to 1.
options: object Same as base case library.

TypeScript and ESM

This package is a pure ESM package and ships with TypeScript definitions. It cannot be require'd or used with CommonJS module resolution in TypeScript.

Change Case

Installation

Usage

Split

Change Case Keys

API

TypeScript and ESM

License

Current Tags

45 Versions