روش replace() رشته JavaScript

تعریف و استفاده

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 آخرین پارامتر می‌تواند یک تابع باشد نه یک رشته. در این حالت، برای هر تطابق، این تابع فراخوانی می‌شود و رشته‌ای که توسط آن بازگردانده می‌شود به عنوان متن جایگزین استفاده می‌شود. پارامتر اول این تابع رشته‌ای است که با الگو تطابق دارد. پارامترهای بعدی رشته‌هایی هستند که با زیرعبارت‌های الگو تطابق دارند و می‌توانند 0 یا بیشتر باشند. پارامتر بعدی یک عدد صحیح است که نشان‌دهنده موقعیت تطابق در string در اینجا قرار دارد. string خود.

پشتیبانی مرورگر

replace() این ویژگی‌ها از ECMAScript1 (ES1) است.

همه مرورگرها به طور کامل از ES1 (JavaScript 1997) پشتیبانی می‌کنند:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی پشتیبانی پشتیبانی پشتیبانی پشتیبانی پشتیبانی

صفحات مرتبط

رشته JavaScript

روش‌های رشته JavaScript

جستجو رشته JavaScript