String.prototype.valueOf()‎

الدالة String.prototype.valueOf()‎ تُعيد القيمة الأوليّة (primitive value).

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

str.valueOf()

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

سلسلة نصية تُمثِّل القيمة الأوليّة لكائن String المعطي.

الوصف

الدالة valueOf()‎ التابعة للكائن String تُعيد القيمة الأوليّة لأحد كائنات String كنوع البيانات string، وهي مكافئة للدالة String.prototype.toString()‎.

تستدعي JavaScript الدالة valueOf لتحويل كائن String إلى قيمة أوليّة، ومن النادر أن تحتاج إلى استدعاء الدالة valueOf يدويًا، إذ تستدعيها JavaScript تلقائيًا عند الحاجة.

أمثلة

استخدام valueOf()‎

var x = new String('Hello world');
console.log(x.valueOf()); // 'Hello world'

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

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

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

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