`Math.atan2()‎`

الدالة Math.atan2()‎ تعيد معكوس الظل (arctangent) لناتج قسمة الوسيطين الممررين إليها.

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

Math.atan2(y, x)

`y`

العدد الأول.

`x`

العدد الثاني.

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

معكوس الظل (arctangent) لناتج قسمة الوسيطين.

الوصف

الدالة Math.atan(x)‎ تُعيد قيمةً عدديةً بين -π و π، وهذه القيمة تُمثِّل الزاوية θ للزاوية التي تقع بين المحور x والمستقيم المار من المبدأ ومن النقطة (x, y) والمُقاسة عكس عقارب الساعة. لاحظ أنَّ الوسائط المُمرَّرة إلى هذه الدالة هي إحداثيات y أولًا ثم إحداثيات x.

الزاوية التي تُعيدها الدالة atan2. — الزاوية التي تُعيدها الدالة `atan2`.

الدالة Math.atan2()‎ تأخذ قيمتين منفصلتين، x و y، بينما الدالة Math.atan()‎ تأخذ قيمةً واحدةً هي نسبة المعاملين على بعضها.

لمّا كانت الدالة atan2 هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.atan2()‎، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن Math ليس له دالةٌ بانية).

أمثلة

Math.atan2(90, 15); // 1.4056476493802699
Math.atan2(15, 90); // 0.16514867741462683

Math.atan2(±0, -0);               // ±PI.
Math.atan2(±0, +0);               // ±0.
Math.atan2(±0, -x);               // ±PI for x > 0.
Math.atan2(±0, x);                // ±0 for x > 0.
Math.atan2(-y, ±0);               // -PI/2 for y > 0.
Math.atan2(y, ±0);                // PI/2 for y > 0.
Math.atan2(±y, -Infinity);        // ±PI for finite y > 0.
Math.atan2(±y, +Infinity);        // ±0 for finite y > 0.
Math.atan2(±Infinity, x);         // ±PI/2 for finite x.
Math.atan2(±Infinity, -Infinity); // ±3*PI/4.
Math.atan2(±Infinity, +Infinity); // ±PI/4.

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

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

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

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