title-case

v4.3.2
Transform a string into title case following English rules
title case english capital sentence convert transform

Title Case

Transform a string into title case following English rules.

Installation

npm install title-case --save

Usage

import { titleCase } from "title-case";

titleCase("string"); //=> "String"
titleCase("follow step-by-step instructions"); //=> "Follow Step-by-Step Instructions"

Options

  • locale?: string | string[] Locale used for toLocaleUpperCase during case transformation (default: undefined)
  • sentenceCase?: boolean Only capitalize the first word of each sentence (default: false)
  • sentenceTerminators?: Set<string> Set of characters to consider a new sentence under sentence case behavior (e.g. ., default: SENTENCE_TERMINATORS)
  • smallWords?: Set<string> Set of words to keep lower-case when sentenceCase === false (default: SMALL_WORDS)
  • titleTerminators?: Set<string> Set of characters to consider a new sentence under title case behavior (e.g. :, default: TITLE_TERMINATORS)
  • wordSeparators?: Set<string> Set of characters to consider a new word for capitalization, such as hyphenation (default: WORD_SEPARATORS)

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.

License

MIT

npm i title-case

Metadata

  • MIT
  • Whatever
  • Blake Embrey
  • released 9/15/2024

Downloads

Maintainers