تخطَّ إلى المحتوى

replace() / replaceAll()

استبدال جزء من نص replace() / replaceAll()

replace() تستبدل أول تطابق فقط، وreplaceAll() تستبدل كل التطابقات — كلاهما يُرجع نصًا جديدًا.

النصوص بجافاسكريبت ثابتة (immutable) — replace/replaceAll لا تعدّلان النص الأصلي أبدًا، بل تُرجعان نسخة جديدة. لاستبدال كل التطابقات بـ replace() القديمة، تحتاج تعبيرًا نمطيًا بعلامة g.

الصياغة

const newStr = str.replace(search, replacement);
const newStr2 = str.replaceAll(search, replacement);

⚡ جرّب بنفسك

عدّل الكود واضغط «تحديث» لترى النتيجة فورًا — التجربة أفضل معلّم.

⚡ محرّر تفاعلي
const text = "أحب جافاسكريبت، جافاسكريبت رائعة";
console.log(text.replace("جافاسكريبت", "JS"));
console.log(text.replaceAll("جافاسكريبت", "JS"));
وحدة التحكّم
اضغط «تشغيل» لرؤية النتيجة هنا.

أهم المعاملات

المعاملالوظيفة
searchالنص أو التعبير النمطي المراد استبداله
replacementالنص الجديد البديل

💡 نصائح عملية

  • replaceAll() (ES2021+) أوضح بكثير من الحاجة لتعبير نمطي بعلامة g لاستبدال الكل

⚠️ أخطاء شائعة

  • توقّع أن replace() تستبدل كل التطابقات — تستبدل فقط أول تطابق ما لم تستخدم تعبيرًا نمطيًا بـ g أو replaceAll

خصائص ذات صلة

🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار JAVASCRIPT الكامل بالعربي.