Workers, Cloudflare CLI - Wrangler and cf now upload source maps by default

<p>From Wrangler 4.150.0, <a href="https://developers.cloudflare.com/workers/wrangler/commands/general/#deploy"><code>wrangler deploy</code></a>, <a href="https://developers.cloudflare.com/workers/wrangler/commands/general/#versions-upload"><code>wrangler versions upload</code></a>, and <a href="https://developers.cloudflare.com/workers/wrangler/commands/workers/#preview"><code>wrangler preview</code></a> generate and upload <a href="https://developers.cloudflare.com/workers/observability/source-maps/">source maps</a> by default. You no longer need to set <code>upload_source_maps</code> to get stack traces with your original file names and line numbers.</p> <p><a href="https://developers.cloudflare.com/cf/"><code>cf deploy</code></a> also uploads source maps by default. With the <a href="https://developers.cloudflare.com/workers/vite-plugin/">Cloudflare Vite plugin</a> 1.64.0 or later, Worker builds generate source maps by default, and <code>cf deploy</code> uploads every source map in the build output.</p> <img src="https://developers.cloudflare.com/cdn-cgi/image/onerror=redirect,width=1850,height=238,format=webp/_astro/with-source-map.PipytmVe.png" alt="Stack Trace with Source Map remapping" loading="lazy" decoding="async" width="1850" height="238"> <p>Remapped stack traces show up in <a href="https://developers.cloudflare.com/workers/observability/logs/workers-logs/">Workers Logs</a>, <a href="https://developers.cloudflare.com/workers/observability/logs/real-time-logs/">real-time logs</a>, <a href="https://developers.cloudflare.com/workers/observability/logs/tail-workers/">Tail Workers</a>, and <a href="https://developers.cloudflare.com/workers/observability/issues/">Workers Issues</a>. Source maps are applied after your Worker runs, so they don't affect CPU time, bundle size, or cold starts.</p> <p>If your Worker uses a custom build, Wrangler uploads any external source maps it finds. Maps it can't resolve, such as inline <code>data:</code> source maps, are skipped instead of failing the upload. Set <code>upload_source_maps</code> to <code>true</code> if you'd prefer the upload to fail.</p> <p>To opt out with Wrangler, set <code>upload_source_maps</code> to <code>false</code>:</p> <div data-nb-tabs data-nb-sync-key="wranglerConfig" class><div class="relative flex border-b border-border" role="tablist" data-nb-tabs-list><span class="bg-primary pointer-events-none absolute -bottom-px h-0.5 rounded-t-sm transition-[left,width] duration-200 ease-out" data-nb-tabs-indicator aria-hidden="true"></span></div><div class="mt-3"><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="wrangler.jsonc" class><figure class="nb-code-figure" data-nb-lang="jsonc"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="jsonc" data-nb-lang="jsonc"><code><span class="line"><span class="nb-shiki-140thh">{</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "upload_source_maps"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-dzsirb">false</span></span> <span class="line"><span class="nb-shiki-140thh">}</span></span></code></pre></figure></div><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="wrangler.toml" class><figure class="nb-code-figure" data-nb-lang="toml"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="toml" data-nb-lang="toml"><code><span class="line"><span class="nb-shiki-140thh">upload_source_maps = </span><span class="nb-shiki-dzsirb">false</span></span></code></pre></figure></div></div></div><script type="module" src="https://developers.cloudflare.com/home/runner/work/cloudflare-docs/cloudflare-docs/src/components/ui/tabs/Tabs.astro?astro&type=script&index=0&lang.ts"></script> <p>To opt out with <code>cf</code> or the Cloudflare Vite plugin, set <code>build.sourcemap</code> to <code>false</code> for your Worker's Vite environment. Refer to <a href="https://developers.cloudflare.com/workers/observability/source-maps/#disable-source-maps">Disable source maps</a>.</p>