1. Home
  2. ChevronRightReferencia de la API de Plugins
  3. ChevronRightPaths

Paths

PluginPathsAPI — resolución segura de rutas en el workspace para plugins de Boltdocs con protección contra directory traversal.

ctx.paths — PluginPathsAPILink

Helpers de resolución de rutas que validan que cada resultado permanezca dentro del workspace. Tanto resolveDocs como resolveAsset rechazan rutas que escapen del directorio base.

const mdxFile = ctx.paths.resolveDocs('guias', 'primeros-pasos', 'instalacion.mdx')
const image = ctx.paths.resolveAsset('public', 'logo.webp')
const fileUrl = ctx.paths.safeFileURL('/ruta/absoluta/diagrama.svg')

Lanzan un Error cuando la ruta resuelta queda fuera del workspace:

// Lanza: Path '../../etc/passwd' resolves to '/etc/passwd' which is
// outside the workspace boundary...
ctx.paths.resolveDocs('../../etc/passwd')

Ver tambiénLink

Last updated on July 27, 2026

Was this page helpful?