JavaScript String replaceAll()

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

replaceAll() این روش برای جستجو در یک رشته از مقدار یا عبارت منظم استفاده می‌شود.

replaceAll() این روش یک رشته جدید را بازمی‌گرداند که تمام مقادیر تطابق‌یافته با جایگزین شده‌اند.

replaceAll() این روش متن اصلی را تغییر نمی‌دهد.

replaceAll() این روش در JavaScript 2021 معرفی شده است.

replaceAll() این روش در Internet Explorer قابل استفاده نیست.

توجه داشته باشید

اگر پارامتر یک عبارت منظم باشد، باید نشانگر جهانی (global) تنظیم شود (g)، در غیر این صورت TypeError خواهد شد.

برای اطلاعات بیشتر در مورد عبارت‌های منظم، لطفاً به:

آموزش عبارت‌های منظم

ارجاع به عبارت‌های منظم

مثال

مثال 1

text = text.replaceAll("Cats","Dogs");
text = text.replaceAll("cats","dogs");

به طور شخصی امتحان کنید

مثال 2

text = text.replaceAll(/Cats/g,"Dogs");
text = text.replaceAll(/cats/g,"dogs");

به طور شخصی امتحان کنید

مثال 2

جایگزینی جهانی و بدون توجه به حروف بزرگ و کوچک:

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

به طور شخصی امتحان کنید

مثال 3

استفاده از تابع برای بازسازی متن:

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

به طور شخصی امتحان کنید

آموزش

string.replaceAll(searchValue, newValue)

پارامتر

پارامتر توضیح
searchValue ضروری. مقدار یا عبارت منظم که باید جستجو شود.
newValue ضروری. مقدار جدیدی که باید جایگزین شود. می‌تواند یک تابع JavaScript باشد.

مقدار بازگشتی

نوع توضیح
String به زبان جدیدی بازمی‌گردد که تمام مقادیر تطبیق داده شده جایگزین شده‌اند.