Local Debugging

Since v1.171.0 the Supabase CLI supports debugging Edge Functions via the v8 inspector protocol, allowing for debugging via Chrome DevTools and other Chromium-based browsers.

Inspect with Chrome Developer Tools

1. Serve your functions in inspect mode. This will set a breakpoint at the first line to pause script execution before any code runs.
   bashCopy

   supabase functions serve --inspect-mode brk
   

2. In your Chrome browser navigate to chrome://inspect.
3. Click the "Configure..." button to the right of the Discover network targets checkbox.
4. In the Target discovery settings dialog box that opens, enter 127.0.0.1:8083 in the blank space and click the "Done" button to exit the dialog box.
5. Click "Open dedicated DevTools for Node" to complete the preparation for debugging. The opened DevTools window will now listen to any incoming requests to edge-runtime.
6. Send a request to your function running locally, e.g. via curl or Postman. The DevTools window will now pause script execution at first line.
7. In the "Sources" tab navigate to file:// > home/deno/functions/<your-function-name>/index.ts.
8. Use the DevTools to set breakpoints and inspect the execution of your Edge Function.

Now you should have Chrome DevTools configured and ready to debug your functions.