Converts a string to uppercase words separated by spaces. Separators and camelCase breaks become word boundaries; the result is readable uppercase phrases. Part of Lodash String (stable since 4.0.0 — not deprecated). Note: not the same as _.toUpper, which keeps original separators.
Pass the string and options shown below. Check the return type before you chain another helper.
Call _.upperCase. Start with this line.
_.upperCase([string=''])| Call | What it does |
|---|---|
_.upperCase([string='']) | Primary signature. |
_.upperCase(string) | Transform or inspect a string. |
Prefer import uppercase from "lodash/uppercase" when you want a smaller bundle.
_.upperCase([string=''])| Parameter | Description |
|---|---|
| string | Optional. Value to convert (default '') |
| Return Value | Description |
|---|---|
| * | Uppercase words separated by spaces |
Hyphens become spaces; words go uppercase.
console.log(_.upperCase("--foo-bar"));
// 'FOO BAR'-- and - mark word edges.foo and bar.A capital letter starts a new word.
console.log(_.upperCase("fooBar"));
// 'FOO BAR'B in fooBar starts a second word.foo and Bar.FOO BAR.Underscores are treated as separators too.
console.log(_.upperCase("__foo_bar__"));
// 'FOO BAR'foo and bar remain._.toUpperSame input, different separator behavior.
var s = "--foo-bar--";
console.log(_.upperCase(s)); // 'FOO BAR'
console.log(_.toUpper(s)); // '--FOO-BAR--'_.toUpper.Turn an identifier into a readable uppercase label.
var key = "userStatus";
console.log(_.upperCase(key));
// 'USER STATUS'user and Status._.startCase for Title Case labels._.upperCase is a Lodash String helper available since 4.0.0. It runs anywhere Lodash runs — modern browsers (via CDN or bundle) and Node.js / Bun / Deno with npm install lodash.
Available in [email protected] full builds and the lodash/upperCase modular import. Works in evergreen browsers and current Node LTS when Lodash is installed.
Bottom line: Safe for production once Lodash is on the page. Prefer import upperCase from "lodash/upperCase" for smaller builds. Native toUpperCase alone does not split words.
Uppercase only the first character of a string.
10 people found this page helpful