Method initialize

src/node/services/experimentsService.ts:80–117

()

  }

  async initialize(): Promise<void> {
    if (this.cacheLoaded) {
      return;
    }

    await this.loadCacheFromDisk();
    this.cacheLoaded = true;

    // Populate telemetry properties from cache immediately so variant breakdowns
    // are present even before a background refresh completes.
    for (const [experimentId, cached] of this.cachedVariants) {
      if (!this.isExperimentSupported(experimentId)) {
        this.telemetryService.setFeatureFlagVariant(this.getFlagKey(experimentId), null);
        continue;
      }

      this.telemetryService.setFeatureFlagVariant(this.getFlagKey(experimentId), cached.value);
    }

    // Renderer overrides must win over cached/remote assignments so server-side gates
    // and telemetry reflect the same explicit user choice on fresh launches.
    for (const [experimentId, enabled] of this.overrides) {
      if (!this.isExperimentSupported(experimentId)) {
        this.telemetryService.setFeatureFlagVariant(this.getFlagKey(experimentId), null);
        continue;
      }

      this.telemetryService.setFeatureFlagVariant(this.getFlagKey(experimentId), enabled);
    }

    // Refresh in background (best effort). We only refresh values that are stale or missing
    // to avoid unnecessary network calls during startup.
    if (this.isRemoteEvaluationEnabled()) {
      for (const experimentId of Object.keys(EXPERIMENTS) as ExperimentId[]) {
        this.maybeRefreshInBackground(experimentId);
      }
    }
  }

  isRemoteEvaluationEnabled(): boolean {
    return (