spirzen/it-knowledge-base: Огромная энциклопедия по информационным технологиям. Компьютерная, цифровая, сетевая грамотность, языки, данные, структуры, интеграции, архитектура, микросервисы, контейнеризация, оркестрация и всё такое.

src/clientModules/limitRoutePrefetch.js

69 строк2 KB

Spirzen

Big design pack

04 июн 2026, 02:45

04 июн 2026, 02:4550bc995

/**
 * Ограничивает фоновый prefetch Docusaurus Link (IntersectionObserver в viewport).
 * window.docusaurus заморожен (Object.freeze) — подменяем ссылку на window, не свойство prefetch.
 */

const HEAVY_ROUTE_PREFIXES = [
  '/about/interactive',
  '/lab/',
  '/encyclopedia/',
];

function normalizePath(pathname) {
  if (!pathname) {
    return '/';
  }
  return pathname.replace(/\/$/, '') || '/';
}

function isHeavyRoute(pathname) {
  const path = normalizePath(pathname);
  return HEAVY_ROUTE_PREFIXES.some(
    (prefix) => path === prefix.replace(/\/$/, '') || path.startsWith(prefix),
  );
}

function installPrefetchGuard() {
  if (typeof window === 'undefined' || !window.docusaurus?.prefetch) {
    return;
  }

  if (window.__itPrefetchGuardInstalled) {
    return;
  }

  const original = window.docusaurus;
  const originalPrefetch = original.prefetch.bind(original);
  const originalPreload = original.preload.bind(original);

  try {
    Object.defineProperty(window, 'docusaurus', {
      value: {
        prefetch(routePath) {
          if (isHeavyRoute(routePath)) {
            return false;
          }
          return originalPrefetch(routePath);
        },
        preload(routePath) {
          return originalPreload(routePath);
        },
      },
      writable: true,
      configurable: true,
      enumerable: true,
    });
    window.__itPrefetchGuardInstalled = true;
  } catch {
    // Не удалось подменить API — остаются prefetch={false} на тяжёлых ссылках
  }
}

export default {
  onClientEntry() {
    installPrefetchGuard();
  },
  onRouteDidUpdate() {
    installPrefetchGuard();
  },
};