التابع ‎‎jQuery.type()‎‎ في jQuery

من موسوعة حسوب
< jQuery‏ | jQuery
اذهب إلى: تصفح، ابحث

jQuery.type( obj )‎

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

يعيد سلسلة نصية (String).

الوصف

يعيد هذا التابع نوع JavaScript الداخلي للكائن المُمرَّر إليه.

jQuery.type( obj )‎

أُضيفت مع الإصدار: 1.4.3

obj

أي شيء، ويمثل الكائن المُراد معرفة نوعه الداخلي في JavaScript.

يستعمل هذا التابع عددًا من التقنيات لتحديد نوع الكائن الذي سنحصل عليه بدقة، إذ يُحدَّد نوع الكائن كما يلي:

  • إن كان الكائن غير مُعرَّف أو ذي قيمة عدميَّة، فستعاد حينئذٍ القيمة "undefined" أو القيمة "null" وفقًا لذلك:
    • jQuery.type( undefined ) === "undefined"‎
    • jQuery.type() === "undefined"‎
    • jQuery.type( window.notDefined ) === "undefined"‎
    • jQuery.type( null ) === "null"‎
  • إن كان الوسيط المُعطى إمَّا قيمةً أوليَّةً أو نسخةً من الكائن ECMAScript المضمَّن، فستُستعمَل الخاصِّيَّة Class الداخليَّة لتحديد النوع (ستجد هنا تفاصيل أوسع عن هذه التقنية):
    • jQuery.type( true ) === "boolean"‎
    • jQuery.type( new Boolean() ) === "boolean"‎
    • jQuery.type( 3 ) === "number"‎
    • jQuery.type( new Number(3) ) === "number"‎
    • jQuery.type( "test" ) === "string"‎
    • jQuery.type( new String("test") ) === "string"‎
    • jQuery.type( function(){} ) === "function"‎
    • jQuery.type( [] ) === "array"‎
    • jQuery.type( new Array() ) === "array"‎
    • jQuery.type( new Date() ) === "date"‎
    • jQuery.type( new Error() ) === "error"‎ بدءًا من الإصدار jQuery 1.9
    • jQuery.type( Symbol() ) === "symbol"‎ بدءًا من الإصدار jQuery 1.9
    • jQuery.type( Object(Symbol()) ) === "symbol"‎ بدءًا من الإصدار jQuery 1.12
    • jQuery.type( /test/ ) === "regexp"‎
  • أمَّا ما تبقى فستعاد القيمة "object" له على أنَّها نوعه.

أمثلة

معرفة إن كان نوع الوسيط المُمرَّر إلى التابع ‎$.type()‎ هو RegExp:
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>jQuery.type مثالٌ عن استعمال التابع</title>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
هل هو RegExp? <b></b>
 
<script>
$( "b" ).append( "" + jQuery.type( /test/ ) );
</script>
 
</body>
</html>

مصادر