Date: 02.04.2017
This update adds an example that was made for an issue. In addition, it also removes some files that shouldnt have been in the NPM package. These are not on Github and should therefore not have been on NPM.
Date: 02.04.2017
Resolves:
This update mostly consists of documentation updates, which doesn't really need an NPM update. Adds legal options for Page.set and Page.get to the documentation. Fixes inconsistencies in the return types of the documentation. Removes static properties from the documentation due to them given no additional information. Also orders all functions in alphabetical order so that the documentation is easier to read.
Lastly, this version updates the dependencies.
Date: 09.08.2016
Adds: Page.onError(handler)
Resolves:
Adds page.onError that had not been added yet. Thanks to @jonathanchrisp for the his pull request. This also fixes #7 by adding notes about page.evaluate not catching errors that are thrown inside the browser. To catch these, page.onError has to be used. It also fixes #6, kind of, by adding a warning whenever you are using arrow functions. Sadly, any ES6 syntax in these specific functions will cause it to throw errors that you cannot see and due to the amount dependencies I would need to include, I cannot check for all ES6 syntax.
Date: 18.04.2016
Changes: Page.set(name, value)
Changes: Page.get(name, value)
Resolves:
Fixes a bug in page.set and page.get where a legal option would throw an error. Also adds more documentation about the header and footer options available.
Date: 18.04.2016
Added: Page.addLocalResource(options)
Added: Page.removeLocalResource(name)
Added: Page.getLocalResource(name)
Added: Page.clearLocalResources()
Added: Page.waitForLoad([timeout])
Resolves: #1
Prior to this version, if you had any local resources when you opened a HTML string or template using either page.openHtml, page.renderHtml, page.openTemplate or page.renderTemplate, these resources wouldn't be retrieved correctly when not using a specific rendering / opening directory. These changes allow you to add resources that you want to be retrievable by the webpage.
The options in page.addLocalResource is of type {name: string, filename: string, content: buffer} where name is a unique name, filename is the name of the file (where it should be stored in the temporary directory) and content is the buffer of the file.
A quick example (using co, for simplicity):
let page = yield phantom.createPage();
let css = 'body {background-color: #ccc;}';
let html = '' +
'<html>' +
'<head>' +
'<title>Title</title>' +
'<link rel="stylesheet" href="css/my-css-file.css">' +
'</head>' +
'</html>';
let cssBuffer = new Buffer(css);
page.addLocalResource({
name : 'mycssfile',
filename: 'css/my-css-file.css',
content : cssBuffer
});
let status = yield page.openHtml(html);The above webpage should now open the string and make a local request for the css file, which should be successful as temporary directory will look something like this (Unix-example):
/tmp/
tmp-XXXXXXX/
tmp-XXXXX.html
css/
my-css-file.css
...
All local resources are saved each time a new page is open and are deleted the moment the page has loaded.
page.getLocalResource will return the resource if it exists, page.removeLocalResource will remove one if it exist and return a boolean that indicates if anything has been removed. page.clearLocalResources will remove all local resources.
Date: 27.12.2015
Changed: Page.renderPdf()
Changed: Page.renderHtml(htmlString, renderDirectory)
Changed: Page.renderTemplate(template, renderDirectory, option)
Due to an issue that sometimes caused the Pdf to be rendered blank, the above mentioned functions has been changed from returning a string to a buffer.
When using buffer.toString() some of the data seems get lost and the rendered PDF was therefore blank.
Due to a breaking change, the version has gone from 2.1 to 3.0.
Date: 26.12.2015
Added: Page.openHtml(htmlString, renderDirectory)
Added: Page.openTemplate(template, renderDirectory, options)
Changed: Page.renderTemplate(template, renderDirectory, options)
Changed: Page.renderHtml(htmlString, renderDirectory)
Changed: Phantom.addCookie(cookie)
Page.openHtml(htmlString, renderDirectory) works much like Page.open(location) but instead of requiring an address, it uses a HTML string. This is done by either saving it to a file with a pseudo-unique name in the renderDirectory specified, or in the operating systems temporary folder, if renderDirectory is omitted. It is then loaded using Page.open before the file is deleted.
Page.openTemplate(template, renderDirectory, options) works exactly as above, but with a template object that has a .render function that returns a HTML string.
Page.renderTemplate(template, renderDirectory, options) has been changed to use Page.openTemplate and therefore works without specifying a renderDirectory.
Page.renderHtml(htmlString, renderDirectory) has been changed to use Page.openHtml. Same changes as above.
It should be noted that if you have any includes (i.e. script src="some-javascript-file.js") that are local files, you should still use a renderDirectory as PhantomJS will try to find these files relative to the render directory.
Phantom.addCookie(cookie) now has type checking, which will throw TypeError on invalid cookies. It is expected to be an object, with a name as well as a value
As with minor versions, none of the changes should be breaking changes and everything should be working as they did in 2.0
Date: 19.12.2015
Added: Page
Added: Phantom
Changed: Too much to specify
Major rewrite of the entire library and now uses node-phantom-simple instead. All functions that PhantomJS include are documented with their documentation. All functions are documented, except for a few which lacks documentation from the creators of PhantomJS.
In addition, this version was also pushed to NPM.
Date: 17.11.2015
Uses phantomjs-node as the wrapper around PhantomJS.