JavaScript String replace() Method

Definition and Usage

korvaa() The method searches for a value or regular expression in the string.

korvaa() The method returns a new string with the replaced value.

korvaa() The method does not change the original string.

Tip:If you replace the value, only the first instance will be replaced. To replace all instances, use the one with g Regular expressions for modifier sets.

See also:

Regular Expression Tutorial

Regular Expression Reference Manual

Instance

Example 1

Replace Microsoft:

let text = "Visit Microsoft!";
let result = text.replace("Microsoft", "W3School");

Kokeile itse!

Example 2

Global replacement:

let text = "Mr Blue has a blue house and a blue car";
let result = text.replace(/blue/g, "red");

Kokeile itse!

Example 3

Global, case-insensitive replacement:

let text = "Mr Blue has a blue house and a blue car";
let result = text.replace(/blue/gi, "red");

Kokeile itse!

Esimerkki 4

Palauta korvaustekstin funktiona:

let text = "Mr Blue has a blue house and a blue car";
let result = text.replace(/blue|house|car/gi, function (x) {
  return x.toUpperCase();
});

Kokeile itse!

syntaksi

merkkijono.korvaa(regexp, korvaus)

parametrit

parametrit kuvaus
regexp

välttämätön. Haettava arvo tai säännöllinen lauseke.

tämä parametri määrittää korvattavan mallin RegExp-objektina.

jos tämä parametri on merkkijono, sitä käytetään haettavaksi suorana merkki-tekstimallina.
korvaus

välttämätön. Merkkijono.

määritetään korvausteksti tai korvaustekstin luovan funktiona.

palautusarvo

tyyppi kuvaus
merkkijono korvattu määritetyllä arvolla uusi merkkijono.

tekniset yksityiskohdat

palautusarvo

palauttaa uuden merkkijonon, joka on korvaus korvattiin regexp ensimmäisen tai kaikkien vastaavien alaketjuiden jälkeen saadun.

selittää

merkkijono merkkijono jossa korvaa() menetelmä suorittaa hakua ja korvausta. Se korvaa merkkijono etsitään regexp vastaavainen alaketju, sitten korvaus korvata nämä alaketjut. Jos regexp on kokonaisuudessaan merkki g:llä, niin korvaa() menetelmä korvaa kaikki vastaavat alaketjut. Muussa tapauksessa se korvaa vain ensimmäisen vastaavan alaketjun.

korvaus voi olla joko merkkijono tai funktio. Jos se on merkkijono, niin jokainen match korvataan merkkijonolla. Mutta korvaus jossa $ merkki on tietyn merkityksen omaava. Kuten alla olevassa taulukossa näkyy, merkkijono, jonka malliin täsmää, käytetään korvaukseen.

merkki korvausteksti
$1、$2、...、$99 vastaavainen regexp jossa 1. ja 99. alaketjut ovat yhdenmukaisia.
$& vastaavainen regexp vastaavainen alaketju.
$` sijaitsee vastaavan alaketjun vasemmalla puolella oleva teksti.
$' sijaitsee vastaavan alaketjun oikealla puolella oleva teksti.
$$ suoraan merkki

Huomaa:ECMAScript v3 määrää,korvaa() menetelmän parametri korvaus voi olla funktio eikä merkkijonon. Tässä tapauksessa kutsutaan jokainen match-funktio, ja se palauttama merkkijono käytetään korvaustekstinä. Funktion ensimmäinen parametri on merkkijono kohteessa olevan sijainnin. Viimeinen parametri on merkkijono itse.

Selaimen tuki

korvaa() Se on ECMAScript1 (ES1) ominaisuus.

Kaikki selaimet tukevat täysin ES1 (JavaScript 1997):

Chrome IE Reuna Firefox Safari Opera
Chrome IE Reuna Firefox Safari Opera
Tuki Tuki Tuki Tuki Tuki Tuki

Liittyvät sivut

JavaScript-merkkijono

JavaScript-merkkijonometodit

JavaScript-merkkijonohaku