克服 TypeScript 中的地区封锁功能：高级架构师的方法

Source: Dev.to

理解挑战

地理封锁通常依赖于检测用户的 IP 所在位置，并限制或修改功能的可访问性。由于许多遗留系统或文档不完善的代码库缺少显式的地理位置标记或配置，资深架构师必须系统性地处理此问题。关键在于在测试期间模拟不同地区，以验证功能可访问性——全部在 TypeScript 环境中完成。

策略概述

我们将重点关注三个核心步骤：

• 模拟环境变量或 API 以模拟不同用户位置。
• 创建测试包装器或工具 来简化基于位置的测试。
• 实现全面的测试，验证各地区的功能可访问性。

步骤 1：在 TypeScript 中模拟地理位置

由于往往缺少直接的文档，首先要弄清系统是如何检测位置的。通常，基于 IP 的地理定位是通过外部 API 或嵌入式服务调用的。下面演示如何进行模拟：

// geoLocationService.ts
export interface Location {
  countryCode: string;
  city?: string;
}

export function fetchUserLocation(): Promise {
  // In production, this would call an external API
  return fetch('/api/location')
    .then(res => res.json());
}

// Mock this during tests
export function mockLocation(location: Location) {
  (fetchUserLocation as any) = () => Promise.resolve(location);
}

在测试中，你可以覆盖 fetchUserLocation 来模拟不同的位置。

步骤 2：构建感知位置的测试工具

创建一个包装功能检查的实用函数，可帮助自动化测试：

export async function testFeatureAccess(
  feature: string,
  allowedCountries: string[]
): Promise {
  const location = await fetchUserLocation();
  if (allowedCountries.includes(location.countryCode)) {
    console.log(`Feature ${feature} should be accessible in ${location.countryCode}`);
    return true;
  } else {
    console.log(`Feature ${feature} is restricted in ${location.countryCode}`);
    return false;
  }
}

这种抽象让你可以指定哪些国家应拥有访问权限，然后以编程方式进行验证。

步骤 3：实现稳健的测试

使用合成数据在多个地区之间自动化测试：

import { mockLocation, testFeatureAccess } from './geoUtils';

describe('Geo-blocked features test', () => {
  const featureName = 'PremiumContent';
  const allowedCountries = ['US', 'GB', 'CA'];

  const testLocations = [
    { countryCode: 'US' },
    { countryCode: 'FR' },
    { countryCode: 'CA' },
    { countryCode: 'JP' }
  ];

  testLocations.forEach(location => {
    it(`should verify access in ${location.countryCode}`, async () => {
      mockLocation(location);
      const hasAccess = await testFeatureAccess(featureName, allowedCountries);
      if (allowedCountries.includes(location.countryCode)) {
        expect(hasAccess).toBe(true);
      } else {
        expect(hasAccess).toBe(false);
      }
    });
  });
});

最后思考

在缺乏明确文档的情况下处理地理限制需要灵活、以测试驱动的方式。通过模拟地理位置数据并自动化测试，资深架构师可以确保功能可访问性符合业务和法律要求。保持环境模块化，并尽快记录地理位置流向，以便后续开发更加顺畅。

🛠️ QA 小贴士

专业提示：使用 TempoMail USA 生成一次性测试账户。