bun:test permite que você altere que horas são nos seus testes.

Isso funciona com qualquer um dos seguintes:

• Date.now
• new Date()
• new Intl.DateTimeFormat().format()

NOTE

Timers ainda não são impactados, mas podem ser em uma versão futura do Bun.

setSystemTime

Para alterar a hora do sistema, use setSystemTime:

test.ts

import { setSystemTime, beforeAll, test, expect } from "bun:test";

beforeAll(() => {
  setSystemTime(new Date("2020-01-01T00:00:00.000Z"));
});

test("é 2020", () => {
  expect(new Date().getFullYear()).toBe(2020);
});

Para oferecer suporte a testes existentes que usam useFakeTimers e useRealTimers do Jest, você pode usar useFakeTimers e useRealTimers:

test.ts

test("assim como no jest", () => {
  jest.useFakeTimers();
  jest.setSystemTime(new Date("2020-01-01T00:00:00.000Z"));
  expect(new Date().getFullYear()).toBe(2020);
  jest.useRealTimers();
  expect(new Date().getFullYear()).toBeGreaterThan(2020);
});

test("diferente do jest", () => {
  const OriginalDate = Date;
  jest.useFakeTimers();
  if (typeof Bun === "undefined") {
    // No Jest, o construtor Date muda
    // Isso pode causar todos os tipos de bugs porque de repente Date !== Date antes do teste.
    expect(Date).not.toBe(OriginalDate);
    expect(Date.now).not.toBe(OriginalDate.now);
  } else {
    // Em bun:test, o construtor Date não muda quando você usa useFakeTimers
    expect(Date).toBe(OriginalDate);
    expect(Date.now).toBe(OriginalDate.now);
  }
});

Redefinir a hora do sistema

Para redefinir a hora do sistema, não passe argumentos para setSystemTime:

test.ts

import { setSystemTime, expect, test } from "bun:test";

test("foi 2020, por um momento.", () => {
  // Defina para algo!
  setSystemTime(new Date("2020-01-01T00:00:00.000Z"));
  expect(new Date().getFullYear()).toBe(2020);

  // Redefina!
  setSystemTime();

  expect(new Date().getFullYear()).toBeGreaterThan(2020);
});

Obter hora mockada com jest.now()

Quando você está usando hora mockada (com setSystemTime ou useFakeTimers), você pode usar jest.now() para obter o timestamp mockado atual:

test.ts

import { test, expect, jest } from "bun:test";

test("obter a hora mockada atual", () => {
  jest.useFakeTimers();
  jest.setSystemTime(new Date("2020-01-01T00:00:00.000Z"));

  expect(Date.now()).toBe(1577836800000); // timestamp de 1 de jan de 2020
  expect(jest.now()).toBe(1577836800000); // Mesmo valor

  jest.useRealTimers();
});

Isso é útil quando você precisa acessar a hora mockada diretamente sem criar um novo objeto Date.

Definir o fuso horário

Por padrão, o fuso horário para todas as execuções de bun test é definido como UTC (Etc/UTC), a menos que seja substituído. Para alterar o fuso horário, passe a variável de ambiente $TZ para bun test:

TZ=America/Los_Angeles bun test

Ou defina process.env.TZ em tempo de execução:

test.ts

import { test, expect } from "bun:test";

test("Bem-vindo à Califórnia!", () => {
  process.env.TZ = "America/Los_Angeles";
  expect(new Date().getTimezoneOffset()).toBe(420);
  expect(new Intl.DateTimeFormat().resolvedOptions().timeZone).toBe("America/Los_Angeles");
});

test("Bem-vindo a Nova York!", () => {
  // Diferente do Jest, você pode definir o fuso horário múltiplas vezes em tempo de execução e funcionará.
  process.env.TZ = "America/New_York";
  expect(new Date().getTimezoneOffset()).toBe(240);
  expect(new Intl.DateTimeFormat().resolvedOptions().timeZone).toBe("America/New_York");
});