String.prototype.toUpperCase()

Метод toUpperCase() повертає той самий рядок, але з літерами переведеними до верхнього регістра (значення буде перетворене на рядок, якщо воно не є рядком).

Синтаксис

str.toUpperCase()

Вертає

Новий рядок із тим самим вмістом, але літерами переведеними до верхнього регістра.

Винятки

TypeError
Якщо викликається для null або undefined, наприклад, String.prototype.toUpperCase.call(undefined).

Опис

Всі малі літери перетворюються на великі, а все решта лишається без змін. Позаяк клас String належить до незмінних типів даних, виклик toUpperCase() створює новий рядок, лишаючи оригінал без змін.

Приклади

Базове використання

console.log('Абетка'.toUpperCase()); // 'АБЕТКА'

Перетворення нерядкових значень this на рядки

Цей метод перетворить будь-яке нерядкове значення на рядок, коли ви присвоюєте його this значення, що не є рядком:

const a = String.prototype.toUpperCase.call({
  toString: function toString() {
    return 'абвгґд';
  }
});

const b = String.prototype.toUpperCase.call(true);

// виводить 'АБВГҐД TRUE'.
console.log(a, b);

Специфікації

Специфікація
ECMAScript (ECMA-262)
The definition of 'String.prototype.toUpperCase' in that specification.

Підтримка веб-переглядачами

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
toUpperCaseChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support 3Opera Full support 3Safari Full support 1WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 10.1Safari iOS Full support 1Samsung Internet Android Full support 1.0nodejs Full support 0.1.100

Legend

Full support  
Full support

Див. також