camelcase
- Version 9.0.0
- Published
- 17.8 kB
- No dependencies
- MIT license
Install
npm i camelcaseyarn add camelcasepnpm add camelcaseOverview
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-bar→fooBar.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 oneto 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[](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>
- Updated .
Package analyzed in 3225 ms. - Missing or incorrect documentation? Open an issue for this package.
