Calculate the angle of a line defined by two points

Use Math.atan2 for the angle from the x axis, in radians or degrees.

JavaScript Version 1.0.0 · MIT · .md

calculate-the-angle-of-a-line-defined-by-two-points.js
function angle({ p1, p2, unit = 'radians' }) { const radians = Math.atan2(p2.y - p1.y, p2.x - p1.x); return unit === 'degrees' ? radians * 180 / Math.PI : radians; }

Input & expected output

Input

{
  "p1": {
    "x": 0,
    "y": 0
  },
  "p2": {
    "x": 1,
    "y": 1
  },
  "unit": "degrees"
}

Expected output

45

The edge case

Input

{
  "p1": {
    "x": 0,
    "y": 0
  },
  "p2": {
    "x": -1,
    "y": 0
  }
}

Expected output

3.141592653589793

Know the limits

  • atan2 handles every quadrant, unlike atan(dy / dx). The result is in (−π, π].
  • In screen coordinates y grows downward, so angles turn clockwise.

The function above is the implementation used by the lab. The lab validates JSON types and caps size before execution; include equivalent validation when accepting untrusted input in your application.

Source & maintenance

Based on Calculate the angle of a line defined by two points from the original 1loc collection by Nguyen Huu Phuoc. Copyright (c) 2020 phuoc-ng. MIT licensed.

Combines the radians and degrees variants behind a unit option. Original MDX retained as inert source evidence.

Maintained by Oveyon. Original source commit: 14b481cf60df. This edition’s file: contents/calculate-the-angle-of-a-line-defined-by-two-points.mdx in akamind/1loc, commit 0a77f131b22d. Read the license.

Local fixture scope · Node.js 22.23.2 · reviewed October 28, 2026. No external service is required.

Keep exploring

Type two or more characters. Try “duplicate”, “webhook” or “retry”.