⬅️ Back to Table of Contents

📄 index.ts

📊 Analysis Summary

Metric	Count
🔧 Functions	2
📦 Imports	12
📊 Variables & Constants	3
🟢 Vue Composition API	1
📑 Type Aliases	3

📚 Table of Contents

• Imports
• Variables & Constants
• Vue Composition API
• Functions
• Type Aliases

🛠️ File Location:

📂 packages/core/useTitle/index.ts

📦 Imports

Name	Source
ReadonlyRefOrGetter	@vueuse/shared
ComputedRef	vue
MaybeRef	vue
MaybeRefOrGetter	vue
Ref	vue
ConfigurableDocument	../_configurable
toRef	@vueuse/shared
tryOnScopeDispose	@vueuse/shared
toValue	vue
watch	vue
defaultDocument	../_configurable
useMutationObserver	../useMutationObserver

---

Variables & Constants

Name	Type	Kind	Value	Exported
originalTitle	string	const	document?.title ?? ''	✗
isReadonly	boolean	const	!!(newTitle && typeof newTitle === 'function')	✗
template	any	const	options.titleTemplate || '%s'	✗

---

Vue Composition API

Name	Type	Reactive Variables	Composables
watch	watch	none	none

---

Functions

useTitle(newTitle: ReadonlyRefOrGetter<string | null | undefined>, options: UseTitleOptions): ComputedRef<string | null | undefined>

Code

export function useTitle(
  newTitle: ReadonlyRefOrGetter<string | null | undefined>,
  options?: UseTitleOptions,
): ComputedRef<string | null | undefined>

• JSDoc:

  /**
   * Reactive document title.
   *
   * @see https://vueuse.org/useTitle
   * @param newTitle
   * @param options
   * @description It's not SSR compatible. Your value will be applied only on client-side.
   */
  

• Parameters:

• newTitle: ReadonlyRefOrGetter<string | null | undefined>
• options: UseTitleOptions
• Return Type: ComputedRef<string | null | undefined>

format(t: string): any

Code

function format(t: string) {
    if (!('titleTemplate' in options))
      return t
    const template = options.titleTemplate || '%s'
    return typeof template === 'function'
      ? template(t)
      : toValue(template).replace(/%s/g, t)
  }

• Parameters:
• t: string
• Return Type: any
• Calls:
• template
• toValue(template).replace

---

Type Aliases

UseTitleOptionsBase

type UseTitleOptionsBase = {
  /**
   * Restore the original title when unmounted
   * @param originTitle original title
   * @returns restored title
   */
  restoreOnUnmount?: false | ((originalTitle: string, currentTitle: string) => string | null | undefined)
} & (
  {
    /**
     * Observe `document.title` changes using MutationObserve
     * Cannot be used together with `titleTemplate` option.
     *
     * @default false
     */
    observe?: boolean
  }
  | {
    /**
     * The template string to parse the title (e.g., '%s | My Website')
     * Cannot be used together with `observe` option.
     *
     * @default '%s'
     */
    titleTemplate?: MaybeRef<string> | ((title: string) => string)
  }
);

UseTitleOptions

type UseTitleOptions = ConfigurableDocument & UseTitleOptionsBase;

UseTitleReturn

type UseTitleReturn = ReturnType<typeof useTitle>;

---