DTK0030: Dock Entry Not Found

Package: @vitejs/devtools

Message

Dock entry with id "{id}" not found

Cause

The internal devtoolskit:internal:docks:on-launch RPC function was called with a dock entry id that does not exist in the docks host. This function is invoked by the DevTools client when a user clicks on a launcher-type dock entry. It looks up the entry by id in context.docks.values(), and if no matching entry is found, it throws this error.

Example

This error is typically triggered by the DevTools client UI, not by plugin code directly. It would occur if a dock entry was unregistered between when the UI rendered the dock panel and when the user clicked the launch button.

// Internally, the client calls:
await rpc.call('devtoolskit:internal:docks:on-launch', 'nonexistent-dock-id')
// Throws DTK0030 because the dock entry does not exist

Fix

Ensure the dock entry is registered before attempting to launch it. If you are writing a plugin that registers dock entries, verify that the entry persists for the lifetime it is expected to be launchable.

context.docks.register({
  id: 'my-plugin:dock',
  label: 'My Dock',
  type: 'launcher',
  launcher: {
    status: 'idle',
    onLaunch: async () => {
      // launch logic
    },
  },
})

If you see this error in the DevTools UI, try refreshing the page to re-synchronize the dock entries.

Source

packages/core/src/node/rpc/internal/docks-on-launch.ts