---
title: String.prototype.toUpperCase()
slug: Web/JavaScript/Reference/Global_Objects/String/toUpperCase
tags:
  - JavaScript
  - Method
  - Prototype
  - String
  - Довідка
translation_of: Web/JavaScript/Reference/Global_Objects/String/toUpperCase
---
<div>{{JSRef}}</div>

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

<p>{{EmbedInteractiveExample("pages/js/string-touppercase.html","shorter")}}</p>

<div class="hidden">
<p>The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> and send us a pull request.</p>
</div>

<h2 id="Синтаксис">Синтаксис</h2>

<pre class="syntaxbox"><code><var>str</var>.toUpperCase()</code></pre>

<h3 id="Вертає">Вертає</h3>

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

<h3 id="Винятки">Винятки</h3>

<dl>
 <dt>{{jsxref("TypeError")}}</dt>
 <dd>Якщо викликається для {{jsxref("null")}} або {{jsxref("undefined")}}, наприклад, <code>String.prototype.toUpperCase.call(undefined)</code>.</dd>
</dl>

<h2 id="Опис">Опис</h2>

<p>Всі малі літери перетворюються на великі, а все решта лишається без змін. Позаяк клас <code>{{jsxref("String")}}</code> належить до незмінних типів даних, виклик <code>toUpperCase()</code> створює новий рядок, лишаючи оригінал без змін.</p>

<h2 id="Приклади">Приклади</h2>

<h3 id="Базове_використання">Базове використання</h3>

<pre class="brush: js">console.log('Абетка'.toUpperCase()); // 'АБЕТКА'
</pre>

<h3 id="Перетворення_нерядкових_значень_this_на_рядки">Перетворення нерядкових значень <code>this</code> на рядки</h3>

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

<pre class="brush: js">const a = String.prototype.toUpperCase.call({
  toString: function toString() {
    return 'абвгґд';
  }
});

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

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

<h2 id="Специфікації">Специфікації</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Специфікація</th>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-string.prototype.touppercase', 'String.prototype.toUpperCase')}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Підтримка_веб-переглядачами">Підтримка веб-переглядачами</h2>

<p class="hidden">Таблиця сумісності на цій сторінці створена зі структурованих даних. Якщо ви хочете долучитися до розробки цих даних, пропонуйте нам свої pull request до репозиторію <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</p>

<p>{{Compat("javascript.builtins.String.toUpperCase")}}</p>

<h2 id="Див._також">Див. також</h2>

<ul>
 <li>{{jsxref("String.prototype.toLocaleLowerCase()")}}</li>
 <li>{{jsxref("String.prototype.toLocaleUpperCase()")}}</li>
 <li>{{jsxref("String.prototype.toLowerCase()")}}</li>
</ul>