webpack-bundle-analyzer
webpack-bundle-analyzer copied to clipboard
Feature Request: Allow JSON and HTML output at the same time.
Rather than adding the plugin twice with e.g.:
[
new BundleAnalyzerPlugin({
analyzerMode: 'static',
openAnalyzer: false,
reportFilename: 'webpack-report/index.html'),
}),
new BundleAnalyzerPlugin({
analyzerMode: 'json',
openAnalyzer: false,
reportFilename: 'webpack-report/index.json'),
}),
]
it would be nice to be able to generate JSON and HTML in one go, e.g.:
[
new BundleAnalyzerPlugin({
analyzerMode: "static",
openAnalyzer: false,
reportOutput: [
{ type: "json", fileName: "webpack-report/index.json" },
{ type: "html", fileName: "webpack-report/index.html" },
],
}),
];
By the way, great work on this plugin. I don't have time right now to contribute this myself, but it would be a valuable addition to us and I just wanted to write the idea down somewhere. π
/cc @Gongreg
Hey, I think it makes sense, but we should get @valscion opinion on it :)
Thanks for the idea! I'm not sure if this works out nicely with all the possible options configurations β it looks like we could end up with configuration that is "invalid" and we would have to write quite a lot of error handling code to deal with this situation.
I believe this is possible already. Here is my example setup:
plugins: [
new BundleAnalyzerPlugin({
analyzerMode: 'static',
reportFilename: '../report/stats.html',
statsFilename: '../report/stats.json',
defaultSizes: 'gzip',
generateStatsFile: true,
openAnalyzer: false
})
]]
This produces at the same time stats.html
and stats.json
. Is this what you wanted to achieve?
@
I believe this is possible already. Here is my example setup:
plugins: [ new BundleAnalyzerPlugin({ analyzerMode: 'static', reportFilename: '../report/stats.html', statsFilename: '../report/stats.json', defaultSizes: 'gzip', generateStatsFile: true, openAnalyzer: false }) ]]
This produces at the same time
stats.html
andstats.json
. Is this what you wanted to achieve?
No, because stats.json is from webpack, report of webpuck-bundle-analyzer is different. You can see at json html and compare it with stats.json - they are different, webpack bundle analyzer report contains information only about chunks
I think it is important feature. I'm writing such script for two bundles comparsion:
- Go to git branch
- Build and analyze
- Save report to temp folder
- Go to other git branch
- Build and analyze
- Save report to temp folder
- Compare two reports.
The issue is that I want to have html reports, but I also need reports in json format to be able to compare reports. There are no beautiful ways to do it: parse html file to get json from it or build twice using different modes. @valscion I think it could be very goo to have ability to pass array to "mode" property:
new BundleAnalyzerPlugin({
analyzerMode: ['json', 'static'],
}),
The expected result is to have to files in build directory: report.html
and report.json
.
Maybe one of the ways to make it more easy is to not add report-json inline in html (window.chartData), but include it on html page using
Hmm yeah, I think adding support for analyzerMode
possibly being an array would be reasonable.
What do you think, @th0r?
Also regarding this:
Maybe one of the ways to make it more easy is to not add report-json inline in html, but include it on html page using
I don't think we need to do that. It would make the handling of report files more difficult as then the report would not be self-contained in a single HTML file anymore, like it now is. At any rate, we could discuss this change as its own change request, outside of the scope of supporting analyzerMode
being an array.
Sorry, I don't have a lot of time currently, but as a workaround, you can also generate your own html file:
Published webpack-bundle-analyzer has a file called:
webpack-bundle-analyzer/public/viewer.js
That file tries to read window.chartData
. If you create a HTML file with the json data set to the window.chartData
, and include the script file it should render correctly.
@valscion @Gongreg For now I came to this solution:
const { getViewerData } = require("webpack-bundle-analyzer/lib/analyzer");
const stats = require("./dist/stats.json");
async function main() {
const report = await getViewerData(stats);
console.log(report) ; // report.json that can be used for two bundles comparing
}
main();
thanks a lot!
Hmm yeah, I think adding support for
analyzerMode
possibly being an array would be reasonable.
Well, I think we can do that, but it will require a change to reportFilename
option to be able to return different filenames for different report types e.g. allow to make it a function (reportType) => <reportFilename>
(which won't work for CLI) or an object {<reportType>: <reportFilename>}
. Anyway, options becomes a mess... We definitely need to ship a new major version with completely revised API with pluggable external reporters.
@valscion @Gongreg For now I came to this solution:
const { getViewerData } = require("webpack-bundle-analyzer/lib/analyzer"); const stats = require("./dist/stats.json"); async function main() { const report = await getViewerData(stats); console.log(report) ; // report.json that can be used for two bundles comparing } main();
thanks a lot!
Do note that you are relying on internal logic and this logic can break even in patch releases. I'm glad that it works for you, though βΊοΈ
We definitely need to ship a new major version with completely revised API with pluggable external reporters.
Yeah, this does indeed sound like it.
So this isn't a trivial update in the end. It would require quite a lot of effort, so don't hold your breath π
@valscion Submitted a PR with a backwards-compatible implementation: https://github.com/webpack-contrib/webpack-bundle-analyzer/pull/442
Really looking forward to this! For now it seems we either have to resort to adding the plugin twice, or disabling it to generate the stats file and then using the CLI.