diff --git a/README.md b/README.md index 6a07fc98..cba86429 100644 --- a/README.md +++ b/README.md @@ -211,6 +211,12 @@ No bundles were parsed. Analyzer will show only original module sizes from stats To get more information about it you can read [issue #147](https://github.com/webpack/webpack-bundle-analyzer/issues/147). +### Cannot display report in Jenkins due to sandboxed iframe + +When viewing a static HTML report through Jenkins (for example with the HTML Publisher plugin), the page can appear blank. Jenkins serves HTML inside a sandboxed iframe that blocks scripts by default, and the report needs JavaScript to render. + +This is a Jenkins Content Security Policy restriction, not a bug in webpack-bundle-analyzer. To view the report you need to relax Jenkins CSP for Directory Browser Support. See [issue #168](https://github.com/webpack/webpack-bundle-analyzer/issues/168#issuecomment-381748354) for details and an example `hudson.model.DirectoryBrowserSupport.CSP` setting. +