camelcase

  • Version 9.0.0
  • Published
  • 17.8 kB
  • No dependencies
  • MIT license

Install

npm i camelcase
yarn add camelcase
pnpm add camelcase

Overview

Convert a dash/dot/underscore/space separated string to camelCase or PascalCase: `foo-bar` → `fooBar`

Index

Functions

Type Aliases

Functions

function camelcase

camelcase: (input: string | readonly string[], options?: Options) => string;
  • Convert a dash/dot/underscore/space separated string to camelCase or PascalCase: foo-barfooBar.

    Correctly handles Unicode strings.

    Parameter input

    The string to convert to camel case.

    Example 1

    import camelCase from 'camelcase';
    camelCase('foo-bar');
    //=> 'fooBar'
    camelCase('foo_bar');
    //=> 'fooBar'
    camelCase('Foo-Bar');
    //=> 'fooBar'
    camelCase('розовый_пушистый_единорог');
    //=> 'розовыйПушистыйЕдинорог'
    camelCase('foo bar');
    //=> 'fooBar'
    console.log(process.argv[3]);
    //=> '--foo-bar'
    camelCase(process.argv[3]);
    //=> 'fooBar'
    camelCase(['foo', 'bar']);
    //=> 'fooBar'
    camelCase(['__foo__', '--bar']);
    //=> '__fooBar'

Type Aliases

type Options

type Options = {
/**
Uppercase the first character: `foo-bar` → `FooBar`
@default false
@example
```
import camelCase from 'camelcase';
camelCase('foo-bar', {pascalCase: true});
//=> 'FooBar'
camelCase('foo-bar', {pascalCase: false});
//=> 'fooBar'
```
*/
readonly pascalCase?: boolean;
/**
Preserve consecutive uppercase characters: `foo-BAR` → `FooBAR`
@default false
@example
```
import camelCase from 'camelcase';
camelCase('foo-BAR', {preserveConsecutiveUppercase: true});
//=> 'fooBAR'
camelCase('foo-BAR', {preserveConsecutiveUppercase: false});
//=> 'fooBar'
````
*/
readonly preserveConsecutiveUppercase?: boolean;
/**
Controls whether letters immediately following digits are treated as word boundaries.
**When `true` (default):**
Capitalize the first letter immediately following a numeric sequence, unless a separator intervenes. This aligns with most utilities, such as Lodash.
**When `false`:**
Do not treat digits as word boundaries. Preserve the original case of letters immediately following digits. Separators still create word boundaries. This follows the Google Java Style Guide which treats numbers as non-boundary characters.
@default true
@example
```
import camelCase from 'camelcase';
camelCase('foo2bar', {capitalizeAfterNumber: true});
//=> 'foo2Bar' (capitalizes 'b' after digit)
camelCase('foo2bar', {capitalizeAfterNumber: false});
//=> 'foo2bar' (preserves lowercase 'b')
// Preserves original case after numbers when false
camelCase('Textures_3d', {capitalizeAfterNumber: false});
//=> 'textures3d' (preserves lowercase 'd')
camelCase('Textures_3D', {capitalizeAfterNumber: false});
//=> 'textures3D' (preserves uppercase 'D')
// Separators still create boundaries
camelCase('foo_2_bar', {capitalizeAfterNumber: false});
//=> 'foo2Bar' ('bar' follows separator, not digit)
```
*/
readonly capitalizeAfterNumber?: boolean;
/**
The locale parameter indicates the locale to be used to convert to upper/lower case according to any locale-specific case mappings. If multiple locales are given in an array, the best available locale is used.
Default: The host environment’s current locale.
@example
```
import camelCase from 'camelcase';
camelCase('lorem-ipsum', {locale: 'en-US'});
//=> 'loremIpsum'
camelCase('lorem-ipsum', {locale: 'tr-TR'});
//=> 'loremİpsum'
camelCase('lorem-ipsum', {locale: ['en-US', 'en-GB']});
//=> 'loremIpsum'
camelCase('lorem-ipsum', {locale: ['tr', 'TR', 'tr-TR']});
//=> 'loremİpsum'
```
Setting `locale: false` ignores the platform locale and uses the [Unicode Default Case Conversion](https://unicode-org.github.io/icu/userguide/transforms/casemappings.html#simple-single-character-case-mapping) algorithm:
@example
```
import camelCase from 'camelcase';
// On a platform with `tr-TR`.`
camelCase('lorem-ipsum');
//=> 'loremİpsum'
camelCase('lorem-ipsum', {locale: false});
//=> 'loremIpsum'
```
*/
readonly locale?: false | string | readonly string[];
};

    Package Files (1)

    Dependencies (0)

    No dependencies.

    Dev Dependencies (3)

    Peer Dependencies (0)

    No peer dependencies.

    Badge

    To add a badge like this onejsDocs.io badgeto your package's README, use the codes available below.

    You may also use Shields.io to create a custom badge linking to https://www.jsdocs.io/package/camelcase.

    • Markdown
      [![jsDocs.io](https://img.shields.io/badge/jsDocs.io-reference-blue)](https://www.jsdocs.io/package/camelcase)
    • HTML
      <a href="https://www.jsdocs.io/package/camelcase"><img src="https://img.shields.io/badge/jsDocs.io-reference-blue" alt="jsDocs.io"></a>