TDD у розробці Node.js

tdd-node/
├── package.json
├── src/
│   └── delivery-fee.js
└── test/
    └── delivery-fee.test.js

{
  "name": "tdd-node-example",
  "version": "1.0.0",
  "private": true,
  "scripts": {
    "test": "node --test"
  }
}

const test = require('node:test');
const assert = require('node:assert/strict');

const { calculateDeliveryFee } = require('../src/delivery-fee');

test('розрахунок вартості доставки', async (t) => {
  await t.test('повертає стандартну вартість для малого замовлення', () => {
    assert.equal(
      calculateDeliveryFee({
        subtotalCents: 4999,
        method: 'standard'
      }),
      599
    );
  });

  await t.test('робить стандартну доставку безкоштовною на порозі', () => {
    assert.equal(
      calculateDeliveryFee({
        subtotalCents: 5000,
        method: 'standard'
      }),
      0
    );
  });

  await t.test('робить стандартну доставку безкоштовною для більшого замовлення', () => {
    assert.equal(
      calculateDeliveryFee({
        subtotalCents: 7500,
        method: 'standard'
      }),
      0
    );
  });

  await t.test('повертає фіксовану ціну експрес-доставки', () => {
    assert.equal(
      calculateDeliveryFee({
        subtotalCents: 10000,
        method: 'express'
      }),
      1299
    );
  });

  await t.test('відхиляє невідомий метод доставки', () => {
    assert.throws(
      () => calculateDeliveryFee({
        subtotalCents: 1000,
        method: 'drone'
      }),
      {
        name: 'RangeError'
      }
    );
  });

  await t.test('відхиляє від’ємну суму замовлення', () => {
    assert.throws(
      () => calculateDeliveryFee({
        subtotalCents: -1,
        method: 'standard'
      }),
      {
        name: 'TypeError'
      }
    );
  });
});

npm test

const STANDARD_FEE_CENTS = 599;
const EXPRESS_FEE_CENTS = 1299;
const FREE_DELIVERY_THRESHOLD_CENTS = 5000;

function calculateDeliveryFee(order) {
  if (!order || !Number.isInteger(order.subtotalCents) || order.subtotalCents < 0) {
    throw new TypeError('subtotalCents має бути невід’ємним цілим числом');
  }

  if (order.method !== 'standard' && order.method !== 'express') {
    throw new RangeError('Невідомий метод доставки');
  }

  if (order.method === 'express') {
    return EXPRESS_FEE_CENTS;
  }

  if (order.subtotalCents >= FREE_DELIVERY_THRESHOLD_CENTS) {
    return 0;
  }

  return STANDARD_FEE_CENTS;
}

module.exports = {
  calculateDeliveryFee
};

npm test

await t.test('самовивіз є безкоштовним', () => {
  assert.equal(
    calculateDeliveryFee({
      subtotalCents: 100,
      method: 'pickup'
    }),
    0
  );
});

if (
  order.method !== 'standard' &&
  order.method !== 'express' &&
  order.method !== 'pickup'
) {
  throw new RangeError('Невідомий метод доставки');
}

if (order.method === 'pickup') {
  return 0;
}

if (order.method !== 'standard' && ...)
if (order.method === 'express')
if (order.method === 'pickup')

const DELIVERY_METHODS = Object.freeze({
  standard: {
    feeCents: 599,
    freeAboveCents: 5000
  },
  express: {
    feeCents: 1299,
    freeAboveCents: null
  },
  pickup: {
    feeCents: 0,
    freeAboveCents: null
  }
});

function validateOrder(order) {
  if (
    !order ||
    !Number.isInteger(order.subtotalCents) ||
    order.subtotalCents < 0
  ) {
    throw new TypeError('subtotalCents має бути невід’ємним цілим числом');
  }

  if (!Object.hasOwn(DELIVERY_METHODS, order.method)) {
    throw new RangeError('Невідомий метод доставки');
  }
}

function calculateDeliveryFee(order) {
  validateOrder(order);

  const policy = DELIVERY_METHODS[order.method];

  if (
    policy.freeAboveCents !== null &&
    order.subtotalCents >= policy.freeAboveCents
  ) {
    return 0;
  }

  return policy.feeCents;
}

module.exports = {
  calculateDeliveryFee
};

npm test

subtotalCents > 5000

subtotalCents >= 5000

test('відхиляє некоректний subtotalCents', async (t) => {
  const invalidValues = [
    undefined,
    null,
    -1,
    10.5,
    '1000',
    NaN
  ];

  for (const subtotalCents of invalidValues) {
    await t.test(`відхиляє значення ${String(subtotalCents)}`, () => {
      assert.throws(
        () => calculateDeliveryFee({
          subtotalCents,
          method: 'standard'
        }),
        {
          name: 'TypeError'
        }
      );
    });
  }
});

написати один тест
→ запустити тести
→ реалізувати мінімальну поведінку
→ запустити тести
→ зробити один refactoring-крок
→ запустити тести

const DELIVERY_METHODS = Object.freeze({
  standard: {
    feeCents: 599,
    freeAboveCents: 5000
  },
  express: {
    feeCents: 1299,
    freeAboveCents: null
  },
  pickup: {
    feeCents: 0,
    freeAboveCents: null
  }
});

function validateOrder(order) {
  if (
    !order ||
    !Number.isInteger(order.subtotalCents) ||
    order.subtotalCents < 0
  ) {
    throw new TypeError('subtotalCents має бути невід’ємним цілим числом');
  }

  if (!Object.hasOwn(DELIVERY_METHODS, order.method)) {
    throw new RangeError('Невідомий метод доставки');
  }
}

function calculateDeliveryFee(order) {
  validateOrder(order);

  const policy = DELIVERY_METHODS[order.method];

  if (
    policy.freeAboveCents !== null &&
    order.subtotalCents >= policy.freeAboveCents
  ) {
    return 0;
  }

  return policy.feeCents;
}

module.exports = {
  calculateDeliveryFee
};

const test = require('node:test');
const assert = require('node:assert/strict');

const { calculateDeliveryFee } = require('../src/delivery-fee');

test('розрахунок вартості доставки', async (t) => {
  await t.test('повертає стандартну вартість для малого замовлення', () => {
    assert.equal(
      calculateDeliveryFee({
        subtotalCents: 4999,
        method: 'standard'
      }),
      599
    );
  });

  await t.test('робить стандартну доставку безкоштовною на порозі', () => {
    assert.equal(
      calculateDeliveryFee({
        subtotalCents: 5000,
        method: 'standard'
      }),
      0
    );
  });

  await t.test('експрес-доставка не залежить від суми замовлення', () => {
    assert.equal(
      calculateDeliveryFee({
        subtotalCents: 10000,
        method: 'express'
      }),
      1299
    );
  });

  await t.test('самовивіз є безкоштовним', () => {
    assert.equal(
      calculateDeliveryFee({
        subtotalCents: 100,
        method: 'pickup'
      }),
      0
    );
  });

  await t.test('відхиляє невідомий метод доставки', () => {
    assert.throws(
      () => calculateDeliveryFee({
        subtotalCents: 1000,
        method: 'drone'
      }),
      {
        name: 'RangeError'
      }
    );
  });

  await t.test('відхиляє від’ємну суму замовлення', () => {
    assert.throws(
      () => calculateDeliveryFee({
        subtotalCents: -1,
        method: 'standard'
      }),
      {
        name: 'TypeError'
      }
    );
  });
});

npm test

assert.equal(calculateDeliveryFee(order), 599);