JavaScript String replace() メソッド

定義と使用方法

replace() メソッドは文字列内で値または正規表現を検索します。

replace() メソッドは置換された値の新しい文字列を返します。

replace() メソッドは元の文字列を変更しません。

ヒント：置換値を指定した場合、最初のインスタンスのみが置換されます。すべてのインスタンスを置換するには、 g 修飾子セットの正規表現。

も参照してください：

正規表現チュートリアル

正規表現リファレンスマニュアル

例

例 1

Microsoft を置換：

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

自分で試してみてください

例 2

全体置換：

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

自分で試してみてください

例 3

全体的、大文字小文字を区別しない置換：

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

自分で試してみてください

例 4

置換テキストを返す関数：

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();
});

自分で試してみてください

文法

string.replace(regexp, replacement)

引数

引数 説明
regexp

必須。検索する値または正規表現。

この引数は、置換するパターンを指定する RegExp オブジェクトです。

この引数が文字列の場合、それを直接量テキストパターンとして使用します。
replacement

必須。文字列。

指定された置換テキストまたは置換テキストを生成する関数。

返値

タイプ 説明
文字列 指定された値で置換された新しい文字列です。

技術的詳細

返値

新しい文字列を返します。これは、 replacement 置換しました。 regexp 最初のマッチングまたはすべてのマッチングの後に得られる。

の

文字列 string の replace() メソッドは検索および置換の操作を実行します。 string 中で regexp にマッチする子文字列を見つけ、 replacement を使用してこれらの子文字列を置換します。 regexp グローバルフラグ g を持つ場合、 replace() メソッドはすべてのマッチング子文字列を置換します。それ以外の場合、最初のマッチング子文字列のみを置換します。

replacement 文字列または関数であります。文字列の場合、各マッチは文字列で置換されますが、 replacement の $ 文字には特定の意味があります。以下の表に示されていますが、パターンマッチから得られた文字列は置換に使用されます。

文字 置換テキスト
$1、$2、...、$99 と regexp の 1 から 99 までの子表达式にマッチするテキスト。
$& と regexp マッチングする子文字列。
$` マッチング子文字列の左側に位置するテキスト。
$' マッチング子文字列の右側に位置するテキスト。
$$ 文字列リテラルシンボル。

注意：ECMAScript v3 では規定されています、replace() メソッドの引数です。 replacement 最後の引数は、 string 中出现する位置。 string 自身で

ブラウザのサポート

replace() ECMAScript1 (ES1) の機能です。

すべてのブラウザは完全に ES1 (JavaScript 1997) をサポートしています：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
サポート サポート サポート サポート サポート サポート

関連ページ

JavaScript 文字列

JavaScript 文字列メソッド

JavaScript 文字列検索