Add getPathSegmentAtLength method

Author: pepelsbey

files/en-us/web/api/svgpathelement/getpathsegmentatlength/index.md

@@ -0,0 +1,68 @@
+---
+title: "SVGPathElement: getPathSegmentAtLength() method"
+short-title: getPathSegmentAtLength()
+slug: Web/API/SVGPathElement/getPathSegmentAtLength
+page-type: web-api-instance-method
+browser-compat: api.SVGPathElement.getPathSegmentAtLength
+---
+
+{{APIRef("SVG")}}
+
+The **`SVGPathElement.getPathSegmentAtLength()`** method returns the segment at a given distance along the path.
+
+## Syntax
+
+```js-nolint
+getPathSegmentAtLength(distance)
+```
+
+### Parameters
+
+- `distance`
+
+  - : A float referring to the distance along the path.
+
+### Return value
+
+A path segment object. If no valid segment exists, returns null.
+
+Segment object has the following properties:
+
+- `type`
+  - : A [path commands](/en-US/docs/Web/SVG/Reference/Attribute/d#path_commands).
+- `values`
+  - : An array or value containing the parameters for the corresponding command.
+
+## Examples
+
+### Get path segment
+
+Consider the following `<path>` element, drawing a square:
+
+```xml
+<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64">
+  <path d="M0,0 h64 v64 h-64 z" />
+</svg>
+```
+
+The `getPathSegmentAtLength()` method will return an object that represents the `v64` segment that lays 65px along the path:
+
+```js
+const path = document.querySelector("path");
+
+console.log(path.getPathSegmentAtLength(65));
+
+// Output: path segment
+// {
+//   type: "v",
+//   values: [64]
+// }
+```
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}

files/en-us/web/api/svgpathelement/index.md

@@ -33,6 +33,8 @@ _This interface also inherits methods from its parent, {{domxref("SVGGeometryEle
   - : Returns the user agent's computed value for the total length of the path in user units.
 - {{domxref("SVGPathElement.setPathData()")}} {{experimental_inline}}
   - : Sets the sequence of path segments as the new path data.
+- {{domxref("SVGPathElement.getPathSegmentAtLength()")}}
+  - : Returns the segment at a given distance along the path.
 
 ### Deprecated methods