jamesarosen / timecop.js

A Javascript library providing "time travel" and "time freezing" capabilities for testing. See also https://github.com/jtrupiano/timecop

What

A port of John Trupiano's awesome Timecop Ruby to Javascript.

How

Call Timecop.install() once to get started. This replaces Date with Timecop.MockDate. After that, you can travel through time at will.

Travel to the morning of October 17, 2010, and allow time to continue advancing:

Timecop.travel(new Date(2010, 10, 17, 11, 45));

Travel to the afternoon of January 21, 2012, and keep time frozen then:

Timecop.freeze(new Date(2012, 1, 21, 14, 30));

Return to the present:

Timecop.returnToPresent();

Finally, to uninstall Timecop and reinstate the native Date constructor:

Timecop.uninstall();

Contributing

See Contributing.md.

timecop.js's Issues

timecop causes jquery-ui-datepicker to not work until timecop is uninstalled

Ran into this conflict on our project. We're using the JQuery UI datepicker for a calendar control. After Timecop.install() is called, the datepicker will no longer "show". As soon as Timecop.uninstall() is called, the seemingly-batched show commands to the datepicker finally get sent and the calendar control shows.

Timecop.install();
$("#search_case_filed_start_date").datepicker("show"); // does not show, no exceptions or JS errors shown in browser
Timecop.uninstall(); // finally shows after uninstall

Timecop.freeze should work once

You should totes rewrite this in CoffeeScript and annotate it with Docco

CoffeeScript is so much more beautiful. You're a beautiful person, James. It makes sense.

Date.UTC should keep working with Timecop installed

Javascript's timezone handling isn't great, but Date.UTC at least provides some way to create a date that isn't attached to an arbitrary and uncontrollable "local time".

Timecop.MockDate.UTC = Timecop.NativeDate.UTC

Add JSLint

Create a Rake- or Makefile and add a JSLint task.

Timecop doesn't provide #setDate()

So after installing timecop and traveling, I have some code like this:

var inThirtyDays = new Date();
inThirtyDays.setDate(new Date().getDate() + 30);

Which, normally, would roll the date forward 30 days. However, if Date has been timecop'd, I instead get:

Result of expression 'inThirtyDays.setDate' [undefined] is not a function

Timecop.js should support other mock/stub frameworks

Mock out browser's current timezone

Anyone here have experience with mocking out the browser's Timezone API? Timecop.travel works great but we have failing tests on our CI server because of the server's timezone

Integration with Timecop gem and rails?

Hi,

has somebody successfully integrated Timecop.js together with the original Timecop gem and rails before?

We have such code in our acceptance tests (using MiniTest and Capybara):

before do
  travel_to 'October 10, 2010'
end

after do
  Timecop.return
end

The problem is that our backend code is now behaving differently from our client code (in our case a jquery-ui datepicker) in this test. Maybe there is a way to inject the right javascript snippets in order to create the same behavior on the client side?

We have a yield :head in our application layout. Maybe this could be used to inject the JS using ActionView::Helpers::CaptureHelper.content_for ? But this is just a vague idea.

Any thoughts anybody?

toISOString() should work

Mocked date objects don't have .toISOString() methods.

Timecop.js should be available as a Node package

Date.now() should work

Date.now() does not appear to be implemented. I had a quick look but couldn't easily fix it myself.

For more details, see: https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Date/now

Timecop.travel should work once

Timecop.js should support stacked events

Timecop.return should work once

package.json

main hasn't the version ("main": "timecop.js") but bower install it with version so, file is timecop-0.1.1 instead of timecop.js that is the library name called. Please, can you change the main to: "main": "timecop-0.1.1.js" ?? Thanks a lot!