document polyfill for phantomjs compatibility

see discussion in #578.

if there's a better place for this documentation, i'm happy to move it.

cc: @yuvii