String.prototype.valueOf()
< JavaScript | String
الدالة 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 .