Skip to content

Upgrading chart.js 1 to 2

Breaking1.1.1 → 2.9.4Breaking11Security4Deprecated17New147Changed64Fixed318Other266

Full comparisonBack to chart.js
BreakingUpgrade verdict

11 breaking changes and 3 security fixes.

In plain terms
  • Dates are no longer automatically converted between types.
  • Renames Chart.layout to Chart.layouts.
  • Doughnut, polar area and radar charts are no longer square by default. Set the aspect ratio to 1 to get the old square shape back.
  • If you used the old radar chart line setting, switch to the two new options instead.
Must act Top 5 of 30 that need code or config changes

Adds chartjs-color ^2.1.0, moment ^2.10.2.

Installs 6 packages in all (was 0).

What you must change

Breaking11
Removes date auto type conversions.
2.8.0GitHub ReleaseSummarizedView source
Renames Chart.layout to Chart.layouts.
Chart.layoutChart.layouts
2.7.2GitHub ReleaseSummarizedView source
Doughnut, polarArea and radar charts now default to aspectRatio 2 and are no longer square; set aspectRatio: 1 to restore the old behaviour.
aspectRatio
2.7.0GitHub ReleaseSummarizedView source
Removes the lineArc setting for the radial linear scale, replaced by gridLines.circular and pointLabels.display.
lineArcgridLines.circularpointLabels.display
2.6.0GitHub ReleaseSummarizedView source
Removes the unused Chart.helpers.cancelAnimFrame method.
Chart.helpers.cancelAnimFrame
2.5.0GitHub ReleaseSummarizedView source
The default aspect ratio is now correctly applied, so polar, doughnut and radar charts render with an aspect ratio of 1 (square).
aspectRatioChart.defaults.doughnut.aspectRatio
2.4.0GitHub ReleaseSummarizedView source
Makes helpers._decimalPlaces private.
helpers._decimalPlaces
2.9.0GitHub ReleaseSummarizedView source
Replaces tooltip item xLabel and yLabel with label and value.
xLabelyLabellabelvalue
2.8.0GitHub ReleaseSummarizedView source
Refactors the bar controller internals, so custom chart types extending the bar controller must be updated.
2.6.0GitHub ReleaseSummarizedView source
The onHover callback now receives 3 parameters, with the event that triggered the hover as the 2nd parameter.
onHoveronClick
2.5.0GitHub ReleaseSummarizedView source
Allows sharing data between charts, requiring changes if dataset.metadata or dataset.metaDataset were used.
dataset.metadatadataset.metaDataset
2.1.0GitHub ReleaseSummarizedView source
Security3
Prevents global prototype pollution via the merge helper.
merge
2.9.4GitHub ReleaseSummarizedView source
Prototype pollution in chart.js
mergeObject.create(null)High · CVSS 7.5
2.9.4GitHub AdvisoryOriginalView source
Removes innerHTML usage from the DOM platform.
innerHTML
2.8.0GitHub ReleaseSummarizedView source

Deprecations to plan for

Deprecated16
Deprecates Chart.{Type} classes.
Chart.{Type}
2.8.0GitHub ReleaseSummarizedView source
Deprecates configMerge and scaleMerge helpers.
configMergescaleMerge
2.8.0GitHub ReleaseSummarizedView source
Documents using parser instead of the deprecated format option.
parserformat
2.8.0GitHub ReleaseSummarizedView source
Deprecates the time scale unitStepSize option in favour of stepSize.
unitStepSizestepSize
2.7.0GitHub ReleaseSummarizedView source
Merges Chart.chart into Chart.
Chart.chartChart
2.6.0GitHub ReleaseSummarizedView source
Merges Chart.Controller into Chart.
Chart.ControllerChart
2.6.0GitHub ReleaseSummarizedView source
Merges Chart.Animation.animationObject into Chart.Animation.
Chart.Animation.animationObjectChart.Animation
2.6.0GitHub ReleaseSummarizedView source
Removes Chart.Animation.chartInstance; use Chart.Animation.chart instead.
Chart.Animation.chartInstanceChart.Animation.chart
2.6.0GitHub ReleaseSummarizedView source
Replaces the 'zero', 'top', 'bottom' fill modes with 'origin', 'start', 'end'.
'zero''top''bottom''origin''start''end'
2.6.0GitHub ReleaseSummarizedView source
Deprecates IPlugin.afterScaleUpdate in favor of the IPlugin.afterLayout hook.
IPlugin.afterScaleUpdateIPlugin.afterLayout
2.5.0GitHub ReleaseSummarizedView source
Extending Chart.PlugingBase is no longer required and is strongly discouraged; use plain JavaScript objects to create and register plugins.
Chart.PlugingBase
2.5.0GitHub ReleaseSummarizedView source
Removes deprecated Chart.pluginService from docs and replaces it with Chart.plugins.
Chart.pluginServiceChart.plugins
2.2.2GitHub ReleaseSummarizedView source
Renames Chart.pluginService to Chart.plugins.
Chart.pluginServiceChart.plugins
2.1.5GitHub ReleaseSummarizedView source
Renames the dataset tension property to lineTension; the old option still works in this release.
tensionlineTension
2.1.0GitHub ReleaseSummarizedView source
Renames the dataset radius property to pointRadius; the old option still works in this release.
radiuspointRadius
2.1.0GitHub ReleaseSummarizedView source
Renames Chart.defaults.Line to Chart.defaults.line; the old option still works in this release.
Chart.defaults.LineChart.defaults.lineChart.defaults.BarChart.defaults.bar
2.1.0GitHub ReleaseSummarizedView source