Skip to content

capaj/proxy-date

Repository files navigation

npm version deps

proxy-date

a minimal utility for painless mocking Date in node.js and Proxy enabled browsers

gif

Why yet another Date mocking library?

Yes there is plenty of them already out there(timekeeper, mockdate atc.), but this one is the only one using proxies. What's so special about proxies? It only intercepts the constructor and .now(). There is no monkeypatching globals like with all the other libraries. Which means any other code relying on Date.constructor for example won't get affected by this. The only downside is this only works for node.js 6 and up.

Install

npm i proxy-date -D
yarn add proxy-date -D

Usage

import { mock, unmock } from 'proxy-date'

mock('2020-01-19T00:20:20.654Z')
new Date().toISOString() //2019-01-19T00:20:20.654Z

unmock()
new Date().toISOString() // now

I like to use this with jest's snapshot tests to ensure I don't have to manually write matchers for every date that happens to occur in a snapshot.

About

a minimal clean utility for mocking Date in any environment featuring ES6 Proxy

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published