JavaScript replace() 方法

String 對象參考手冊 JavaScript String 對象

實例

在本例中,我們將執行一次替換,當第一個 "Microsoft" 被找到,它就被替換為 "zaixian":

var str="Visit Microsoft! Visit Microsoft!"; var n=str.replace("Microsoft","zaixian");

n 輸出結果:

Visit zaixian!Visit Microsoft!


定義和用法

replace() 方法用於在字串中用一些字元替換另一些字元,或替換一個與正則運算式匹配的子串。

如果想瞭解更多正則運算式教學請查看本站的:RegExp 教學 和 our RegExp 對象參考手冊.

該方法不會改變原始字串。


流覽器支持

Internet ExplorerFirefoxOperaGoogle ChromeSafari

所有主要流覽器都支持 replace() 方法。


語法

string.replace(searchvalue,newvalue)

參數值

參數 描述
searchvalue 必須。規定子字串或要替換的模式的 RegExp 對象。
請注意,如果該值是一個字串,則將它作為要檢索的直接量文本模式,而不是首先被轉換為 RegExp 對象。
newvalue 必需。一個字串值。規定了替換文本或生成替換文本的函數。

返回值

類型 描述
String 一個新的字串,是用 replacement 替換了 regexp 的第一次匹配或所有匹配之後得到的。

技術細節

JavaScript 版本: 1.2


更多實例

實例

執行一個全局替換:

var str="Mr Blue has a blue house and a blue car"; var n=str.replace(/blue/g,"red");

n 輸出結果:

Mr Blue has a red house and a red car


實例

執行一個全局替換, 忽略大小寫:

var str="Mr Blue has a blue house and a blue car"; var n=str.replace(/blue/gi, "red");

n 輸出結果:

Mr red has a red house and a red car

實例

在本例中,我們通過 prototype 為 JavaScript 的 String 對象添加方法,來實現將所有 "Microsoft" 替換為 "zaixian":

String.prototype.replaceAll = function(search, replacement) { var target = this; return target.replace(new RegExp(search, 'g'), replacement); };



String 對象參考手冊 JavaScript String 對象