CKTIS / JavaScript
String.prototype.toUpperCase() — pretvorba črk v velike črke
Metoda toUpperCase() vrne besedilo, v katerem so črke pretvorjene v velike črke po privzetih pravilih Unicode. Izvirnika ne spremeni, ne sprejema argumentov in lahko spremeni dolžino rezultata.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
string.toUpperCase()String.prototype.toUpperCase() vrne vrednost vrste string s črkami, pretvorjenimi v velike črke po privzetem algoritmu Unicode. Pokličite jo kot string.toUpperCase() brez argumentov. Izvirno besedilo ostane nespremenjeno; če želite uporabiti pretvorjeno besedilo, shranite ali posredujte vrnjeno vrednost.
Pretvorba ni omejena na ASCII. Ena kodna točka se lahko pretvori v več njih, zato se lahko dolžina rezultata spremeni: ß postane SS. Števke in ločila v primeru ostanejo nespremenjeni. Pretvorba v velike in nato v male črke ne zagotavlja, da boste dobili izvirnik nazaj.
Metoda ne upošteva izbranega jezika ali področnih nastavitev. Če potrebujete pravila za velike črke, odvisna od jezika, razmislite o toLocaleUpperCase(). Sama metoda toUpperCase() ni splošni mehanizem za primerjanje besedila brez razlikovanja med velikimi in malimi črkami.
Metodo lahko pokličete tudi z String.prototype.toUpperCase.call(value), pri čemer je value sprejemnik klica. Pri null in undefined sproži TypeError še pred pretvorbo. Sicer uporabi operacijo ToString, ki pri primitivni vrednosti tipa Symbol sproži TypeError. Je del standardne knjižnice ECMAScript, ne DOM-a; jezikovna specifikacija ni tabela združljivosti brskalnikov.
Primeri
const original = "Straße 123!";
const upper = original.toUpperCase();
console.log(original);
console.log(upper);
console.log(original.length, upper.length);Rezultat
Straße 123! STRASSE 123! 11 12
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.