diff --git a/Conversions/SpeedConversion.js b/Conversions/SpeedConversion.js
new file mode 100644
index 0000000000..b79a50bac3
--- /dev/null
+++ b/Conversions/SpeedConversion.js
@@ -0,0 +1,65 @@
+/**
+ * Speed conversion
+ *
+ * This function converts speed units including kilometers per hour (km/h),
+ * meters per second (m/s), miles per hour (mph), and knots (knot).
+ *
+ * https://en.wikipedia.org/wiki/Kilometres_per_hour
+ * https://en.wikipedia.org/wiki/Miles_per_hour
+ * https://en.wikipedia.org/wiki/Metre_per_second
+ * https://en.wikipedia.org/wiki/Knot_(unit)
+ *
+ * chart for unit conversions.
+ *
+ * @constant {Object} speedChart
+ * @property {number} speedChart['km/h'] - Conversion factor for kilometers per hour (km/h).
+ * @property {number} speedChart['m/s'] - Conversion factor for meters per second (m/s).
+ * @property {number} speedChart['mph'] - Conversion factor for miles per hour (mph).
+ * @property {number} speedChart['knot'] - Conversion factor for knots (knot).
+ */
+const speedChart = {
+ 'km/h': 1.0,
+ 'm/s': 3.6,
+ mph: 1.609344,
+ knot: 1.852
+}
+
+/**
+ * Inverse speed conversion chart for unit conversions.
+ *
+ * @constant {Object} speedChartInverse
+ * @property {number} speedChartInverse['km/h'] - Inverse conversion factor for kilometers per hour (km/h).
+ * @property {number} speedChartInverse['m/s'] - Inverse conversion factor for meters per second (m/s).
+ * @property {number} speedChartInverse['mph'] - Inverse conversion factor for miles per hour (mph).
+ * @property {number} speedChartInverse['knot'] - Inverse conversion factor for knots (knot).
+ */
+const speedChartInverse = {
+ 'km/h': 1.0,
+ 'm/s': 0.277777778,
+ mph: 0.621371192,
+ knot: 0.539956803
+}
+
+/**
+ * Convert speed from one unit to another using the speedChart and speedChartInverse.
+ *
+ * @param {number} speed - The speed value to be converted.
+ * @param {string} inputUnit - The source unit (e.g., 'km/h', 'm/s', 'mph', 'knot').
+ * @param {string} outputUnit - The target unit (e.g., 'km/h', 'm/s', 'mph', 'knot').
+ * @throws {Error} Throws an error if the source or target unit is not recognized.
+ * @returns {number} The converted speed value.
+ */
+const convertSpeed = (speed, inputUnit, outputUnit) => {
+ if (!(outputUnit in speedChart) || !(inputUnit in speedChartInverse)) {
+ const validUnits = Object.keys(speedChartInverse).join(', ')
+ throw new Error(
+ `Incorrect 'inputUnit' or 'outputUnit' value: ${inputUnit}, ${outputUnit}\n Valid values are: ${validUnits}`
+ )
+ }
+
+ return parseFloat(
+ (speed * speedChart[inputUnit] * speedChartInverse[outputUnit]).toFixed(3)
+ )
+}
+
+export { convertSpeed }
diff --git a/Conversions/test/SpeedConversion.test.js b/Conversions/test/SpeedConversion.test.js
new file mode 100644
index 0000000000..5f376c79bb
--- /dev/null
+++ b/Conversions/test/SpeedConversion.test.js
@@ -0,0 +1,51 @@
+import { convertSpeed } from '../SpeedConversion'
+
+describe('Speed Unit Conversions', () => {
+ it('100 km/h to m/s', () => {
+ expect(convertSpeed(100, 'km/h', 'm/s')).toBe(27.778, 3)
+ })
+
+ it('100 km/h to mph', () => {
+ expect(convertSpeed(100, 'km/h', 'mph')).toBe(62.137, 3)
+ })
+
+ it('100 km/h to knot', () => {
+ expect(convertSpeed(100, 'km/h', 'knot')).toBe(53.996, 3)
+ })
+
+ it('100 m/s to km/h', () => {
+ expect(convertSpeed(100, 'm/s', 'km/h')).toBe(360.0, 3)
+ })
+
+ it('100 m/s to mph', () => {
+ expect(convertSpeed(100, 'm/s', 'mph')).toBe(223.694, 3)
+ })
+
+ it('100 m/s to knot', () => {
+ expect(convertSpeed(100, 'm/s', 'knot')).toBe(194.384, 3)
+ })
+
+ it('100 mph to km/h', () => {
+ expect(convertSpeed(100, 'mph', 'km/h')).toBe(160.934, 3)
+ })
+
+ it('100 mph to m/s', () => {
+ expect(convertSpeed(100, 'mph', 'm/s')).toBe(44.704, 3)
+ })
+
+ it('100 mph to knot', () => {
+ expect(convertSpeed(100, 'mph', 'knot')).toBe(86.898, 3)
+ })
+
+ it('100 knot to km/h', () => {
+ expect(convertSpeed(100, 'knot', 'km/h')).toBe(185.2, 3)
+ })
+
+ it('100 knot to m/s', () => {
+ expect(convertSpeed(100, 'knot', 'm/s')).toBe(51.444, 3)
+ })
+
+ it('100 knot to mph', () => {
+ expect(convertSpeed(100, 'knot', 'mph')).toBe(115.078, 3)
+ })
+})
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy