String.prototype.trim()‎

الدالة String.prototype.trim()‎ تُزيل الفراغات من بداية ونهاية السلسلة النصية؛ والفراغات المذكورة هنا هي جميع محارف الفراغات (الفراغ العادي، ومسافة الجدولة [tab]، والفراغ الذي لا يقبل القسم [no-break space] ...إلخ.) وجميع محارف نهاية الأسطر (LF و CR ...إلخ.).

البنية العامة

str.trim()

القيمة المعادة

سلسلة نصية جديدة تُمثِّل السلسلة النصية الأصلية لكن مع إزالة جميع الفراغات من بدايتها ونهايتها.

الوصف

تُعيد هذه الدالة سلسلة نصية جديدة تُمثِّل السلسلة النصية الأصلية لكن مع إزالة جميع الفراغات من بدايتها ونهايتها. لاحظ أنَّ هذه الدالة لن تؤثر على السلسلة النصية الأصلية.

أمثلة

استخدام trim()‎

المثال الآتي يخرج السلسلة النصية 'foo':

var orig = '   foo  ';
console.log(orig.trim()); // 'foo'

// مثال آخر عن سلسلة نصية فيها فراغات من جهة واحدة فقط

var orig = 'foo    ';
console.log(orig.trim()); // 'foo'

تعويض نقص دعم المتصفحات

الشيفرة الآتية تُعرِّف الدالة trim وذلك إن لم تكن مدعومةً من بعض المتصفحات القديمة:

if (!String.prototype.trim) {
  String.prototype.trim = function () {
    return this.replace(/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, '');
  };
}

دعم المتصفحات

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	نعم	3.5	9	10.5	5

مصادر ومواصفات

• مسودة المعيار ECMAScript Latest Draft.
• معيار ECMAScript 2015 (6th Edition)‎.
• معيار ECMAScript 5.1.