Home / Function/ createBundleRendererCreator() — vue Function Reference

createBundleRendererCreator() — vue Function Reference

Architecture documentation for the createBundleRendererCreator() function in create-bundle-renderer.ts from the vue codebase.

Entity Profile

Dependency Diagram

graph TD
  a0250ae2_2716_65d8_1d1d_df4785a5c81f["createBundleRendererCreator()"]
  4d17b2cd_8341_be4c_da34_2ed4e0539f4a["createSourceMapConsumers()"]
  a0250ae2_2716_65d8_1d1d_df4785a5c81f -->|calls| 4d17b2cd_8341_be4c_da34_2ed4e0539f4a
  0ef8eb2c_b0fb_7608_a58e_c6b068a0d511["createRenderer()"]
  a0250ae2_2716_65d8_1d1d_df4785a5c81f -->|calls| 0ef8eb2c_b0fb_7608_a58e_c6b068a0d511
  869be535_8c3a_65b4_18ae_17f1ba134e94["createBundleRunner()"]
  a0250ae2_2716_65d8_1d1d_df4785a5c81f -->|calls| 869be535_8c3a_65b4_18ae_17f1ba134e94
  2e2c8bb3_8474_7b2e_e72a_577b6d3c8760["createPromiseCallback()"]
  a0250ae2_2716_65d8_1d1d_df4785a5c81f -->|calls| 2e2c8bb3_8474_7b2e_e72a_577b6d3c8760
  84354631_63fc_95c1_5d39_e0e359ee44f3["rewriteErrorTrace()"]
  a0250ae2_2716_65d8_1d1d_df4785a5c81f -->|calls| 84354631_63fc_95c1_5d39_e0e359ee44f3
  style a0250ae2_2716_65d8_1d1d_df4785a5c81f fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/server-renderer/src/bundle-renderer/create-bundle-renderer.ts lines 32–159

export function createBundleRendererCreator(
  createRenderer: (options?: RenderOptions) => Renderer
) {
  return function createBundleRenderer(
    bundle: string | RenderBundle,
    rendererOptions: RenderOptions = {}
  ) {
    let files, entry, maps
    let basedir = rendererOptions.basedir

    // load bundle if given filepath
    if (
      typeof bundle === 'string' &&
      /\.js(on)?$/.test(bundle) &&
      path.isAbsolute(bundle)
    ) {
      if (fs.existsSync(bundle)) {
        const isJSON = /\.json$/.test(bundle)
        basedir = basedir || path.dirname(bundle)
        bundle = fs.readFileSync(bundle, 'utf-8')
        if (isJSON) {
          try {
            // @ts-expect-error
            bundle = JSON.parse(bundle)
          } catch (e: any) {
            throw new Error(`Invalid JSON bundle file: ${bundle}`)
          }
        }
      } else {
        throw new Error(`Cannot locate bundle file: ${bundle}`)
      }
    }

    if (typeof bundle === 'object') {
      entry = bundle.entry
      files = bundle.files
      basedir = basedir || bundle.basedir
      maps = createSourceMapConsumers(bundle.maps)
      if (typeof entry !== 'string' || typeof files !== 'object') {
        throw new Error(INVALID_MSG)
      }
    } else if (typeof bundle === 'string') {
      entry = '__vue_ssr_bundle__'
      files = { __vue_ssr_bundle__: bundle }
      maps = {}
    } else {
      throw new Error(INVALID_MSG)
    }

    const renderer = createRenderer(rendererOptions)

    const run = createBundleRunner(
      entry,
      files,
      basedir,
      rendererOptions.runInNewContext
    )

    return {
      renderToString: (context?: Object | undefined, cb?: any) => {
        if (typeof context === 'function') {
          cb = context
          context = {}
        }

        let promise
        if (!cb) {
          ;({ promise, cb } = createPromiseCallback())
        }

        run(context)
          .catch(err => {
            rewriteErrorTrace(err, maps)
            cb(err)
          })
          .then(app => {
            if (app) {
              //@ts-expect-error
              renderer.renderToString(app, context, (err, res) => {
                rewriteErrorTrace(err, maps)
                cb(err, res)
              })
            }
          })

        return promise
      },

      renderToStream: (context?: Object) => {
        const res = new PassThrough()
        run(context)
          .catch(err => {
            rewriteErrorTrace(err, maps)
            // avoid emitting synchronously before user can
            // attach error listener
            process.nextTick(() => {
              res.emit('error', err)
            })
          })
          .then(app => {
            if (app) {
              //@ts-expect-error
              const renderStream = renderer.renderToStream(app, context)

              renderStream.on('error', err => {
                rewriteErrorTrace(err, maps)
                res.emit('error', err)
              })

              // relay HTMLStream special events
              if (rendererOptions && rendererOptions.template) {
                renderStream.on('beforeStart', () => {
                  res.emit('beforeStart')
                })
                renderStream.on('beforeEnd', () => {
                  res.emit('beforeEnd')
                })
              }

              renderStream.pipe(res)
            }
          })

        return res
      }
    }
  }
}

Subdomains

Frequently Asked Questions

What does createBundleRendererCreator() do?
createBundleRendererCreator() is a function in the vue codebase.
What does createBundleRendererCreator() call?
createBundleRendererCreator() calls 5 function(s): createBundleRunner, createPromiseCallback, createRenderer, createSourceMapConsumers, rewriteErrorTrace.

Analyze Your Own Codebase

Get architecture documentation, dependency graphs, and domain analysis for your codebase in minutes.

Try Supermodel Free