str-case-converter

A lightweight utility for converting strings between different case formats. Automatically detects input case format or lets you specify it explicitly.

Installation

1npm install str-case-converter

Usage

1import { convertString } from 'str-case-converter';
2
3// Basic usage (auto-detects source case)
4convertString.toCamel('hello-world'); // 'helloWorld'
5convertString.toSnake('helloWorld'); // 'hello_world'
6convertString.toPascal('hello_world'); // 'HelloWorld'
7convertString.toKebab('HelloWorld'); // 'hello-world'
8convertString.toConstant('helloWorld'); // 'HELLO_WORLD'
9convertString.toTitle('hello-world'); // 'Hello World'
10convertString.toDot('Hello World'); // 'hello.world'
11convertString.toNo('helloWorld'); // 'hello world'
12convertString.toSentence('hello_world'); // 'Hello world'
13convertString.toPath('Hello World'); // 'hello/world'
14
15// Utility methods
16convertString.detect('helloWorld'); // 'camel'
17convertString.toArray('hello-world'); // ['hello', 'world']
18convertString.capitalize('hello'); // 'Hello'
19
20// Specify source case for better performance/control
21convertString.toCamel('hello-world', 'kebab'); // 'helloWorld'
22convertString.toSnake('hello-world', 'kebab'); // 'hello_world'

Supported Cases

• camelCase: 'helloWorld'
• PascalCase: 'HelloWorld'
• snake_case: 'hello_world'
• kebab-case: 'hello-world'
• CONSTANT_CASE: 'HELLO_WORLD'
• Title Case: 'Hello World'
• dot.case: 'hello.world'
• no case: 'hello world'
• Sentence case: 'Hello world'
• path/case: 'hello/world'

Features

• Auto-detection of input case format
• Optional source case specification
• Handles mixed cases, unknown formats and non string types
• No dependencies
• Lightweight and efficient
• ESM support

API

Main Methods

All conversion methods accept two parameters:

• str: string - The string to convert
• sourceCase?: string - Optional source case type for better performance/control

1convertString.toCamel(str, sourceCase?)     // Converts to camelCase
2convertString.toPascal(str, sourceCase?)    // Converts to PascalCase
3convertString.toSnake(str, sourceCase?)     // Converts to snake_case
4convertString.toKebab(str, sourceCase?)     // Converts to kebab-case
5convertString.toConstant(str, sourceCase?)  // Converts to CONSTANT_CASE
6convertString.toTitle(str, sourceCase?)     // Converts to Title Case
7convertString.toDot(str, sourceCase?)       // Converts to dot.case
8convertString.toNo(str, sourceCase?)        // Converts to no case
9convertString.toSentence(str, sourceCase?)  // Converts to Sentence case
10convertString.toPath(str, sourceCase?)      // Converts to path/case

Utility Methods

1convertString.detect(str); // Returns the case type or null if unknown
2convertString.toArray(str); // Converts string to array of words
3convertString.capitalize(str); // Capitalize the first character

Tips

• You can destructure the method you need to avoid calling the object.
• Ultimately, you can pass anything you want as arguments.
• The first argument will always be converted into a string.
• The second argument will allow you to skip the detect function no matter what and will be compared to valid case names

1// destructuring
2const { toCamel } = convertString;
3['hello-world', 'foo-bar'].map((str) => toCamel(str));
4
5// using unknown case format
6toCamel('AR3_y0u-GONNA break Yet?', null); // 'ar3Y0uGonnaBreakYet?'
7
8// converting other types
9convertString.toConstant(undefined, {}); // 'UNDEFINED'
10
11// control the output with the case format
12convertString.toSnake(
13    'If I useTitle-case as an argument, it will only remove spaces/uppercases',
14    'title'
15);
16// if_i_usetitle-case_as_an_argument,_it_will_only_remove_spaces/uppercases

License

MIT

Issues

If you find a bug or have a suggestion, please file an issue on GitHub.