JavaScript String replaceAll()

التعريف والاستخدام

replaceAll() تستخدم الطريقة للبحث عن القيمة المحددة أو التعبير العادي في النص.

replaceAll() تقوم الطريقة بتحويل جميع القيم المتطابقة إلى نص جديد تم استبدالها.

replaceAll() لا تغير الطريقة النص الأصلي.

replaceAll() تم إدخال الطريقة في JavaScript 2021.

replaceAll() الطريقة غير متاحة في Internet Explorer.

ملاحظة

إذا كان المعامل هو التعبير العادي، فيجب تعيين علامة العالمية (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 يعيد النص الجديد الذي تم استبدال جميع القيم المطابقة به.