Skip to content

mgwalker/chartjs-node

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

snapshot test status badge

Chart.js-node

Build static Chart.js 3.x charts in Node. It's a lot like using Chart.js directly, but with a few tweaks.

Getting started

npm install @mgwalker/chartjs-node

And then to use it:

import Chart from "@mgwalker/chartjs-node";

const myChart = new Chart([width, height], config);

The config option is a complete Chart.js configuration object, including datasets, options, etc. Note that options.animations is always set to false since the rendered image is static.

chartjs-node includes chartjs-adapter-luxon, chartjs-plugin-annotation, and chartjs-plugin-datalabels, so you can also use any configuration for those. Please note that the datalabels plugin is disabled unless you provide configuration for it.

Other plugins are not included because they don't work with Chart.js 3.x.

The config can also include some options that are specific to chartjs-node:

path description default
deviceScaleFactor When rendering the image, what device scale factor to use. Set larger to get clearer antialiasing. 1
options.backgroundColor The background color of the generated chart. white

To save your chart:

await myChart.save([path]);

If path is provided, the chart will be saved as a PNG to the provided path. If path is omitted, save() will resolve with a buffer containing the PNG.