headTagInsertCheck() — vite Function Reference

Architecture documentation for the headTagInsertCheck() function in html.ts from the vite codebase.

Function typescript PluginSystem LegacySupport calls 1 called by 1

Entity Profile

PluginSystem→ LegacySupport→ headTagInsertCheck() — vite Function Reference

Dependency Diagram

graph TD
  08c41a93_79ac_548f_29e5_24bc0973e731["headTagInsertCheck()"]
  f8fe0737_718a_5509_b722_473f207d5906["html.ts"]
  08c41a93_79ac_548f_29e5_24bc0973e731 -->|defined in| f8fe0737_718a_5509_b722_473f207d5906
  979ed295_1d80_37c1_156b_2bbf25fc21e4["applyHtmlTransforms()"]
  979ed295_1d80_37c1_156b_2bbf25fc21e4 -->|calls| 08c41a93_79ac_548f_29e5_24bc0973e731
  cd876c7b_825e_7e39_9771_1b4f9bfc7754["unique()"]
  08c41a93_79ac_548f_29e5_24bc0973e731 -->|calls| cd876c7b_825e_7e39_9771_1b4f9bfc7754
  style 08c41a93_79ac_548f_29e5_24bc0973e731 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/vite/src/node/plugins/html.ts lines 1346–1368

function headTagInsertCheck(
  tags: HtmlTagDescriptor[],
  ctx: IndexHtmlTransformContext,
) {
  if (!tags.length) return
  const { logger } = ctx.server?.config || {}
  const disallowedTags = tags.filter(
    (tagDescriptor) => !elementsAllowedInHead.has(tagDescriptor.tag),
  )

  if (disallowedTags.length) {
    const dedupedTags = unique(
      disallowedTags.map((tagDescriptor) => `<${tagDescriptor.tag}>`),
    )
    logger?.warn(
      colors.yellow(
        colors.bold(
          `[${dedupedTags.join(',')}] can not be used inside the <head> Element, please check the 'injectTo' value`,
        ),
      ),
    )
  }
}