多页面切换

在 UI 自动化测试中，多页面切换是高频场景（如登录后跳主页、点击菜单打开新标签、iframe 嵌套页面、弹窗跳转等），核心是「定位页面标识 + 切换上下文 + 等待页面就绪」，避免因页面未加载完成或上下文错误导致元素定位失败。以下结合 Selenium（Web 端） 和 Appium（移动端） ，分场景讲清实现方案、代码示例和避坑技巧，完全适配你在「阶段 2：自动化测试进阶期」的实操需求。

一、核心前提：明确 “页面切换” 的 3 类核心场景

多页面切换的本质是「切换操作的 “上下文”」（比如从当前窗口切到新窗口、从主文档切到 iframe），先分清场景再选方案：

场景类型	典型例子	核心操作
1. 同一窗口内页面跳转	登录页 → 首页、列表页 → 详情页	等待新页面加载完成 + 验证页面特征
2. 新窗口 / 新标签页切换	点击 “帮助中心” 打开新标签、弹窗式新窗口	获取所有窗口句柄 → 切换到目标窗口
3. iframe/frame 嵌套切换	页面内嵌入表单（如登录框、支付弹窗）	切换到 iframe 上下文 → 操作元素 → 切回主文档
4. 移动端页面切换（App）	Activity 跳转（如首页 → 我的页面）、Fragment 切换	等待 Activity 启动 + 验证页面元素

二、Web 端多页面切换实现（Selenium + Python）

以 Selenium 4.x + Pytest + POM 模式 为基础，结合显式等待（关键！避免超时），分场景实现：

场景 1：同一窗口内页面跳转（最常用）

核心逻辑：

点击跳转按钮后，等待新页面的 “唯一标识” 加载完成（如页面标题、核心元素、URL），再执行后续操作（避免用 time.sleep()，不稳定）。

实现步骤 + 代码示例：

1. 封装 BasePage 基类（复用等待逻辑）；
2. 子页面类继承 BasePage，定义页面唯一标识；
3. 跳转后通过标识验证页面切换成功。

# 1. 基类 BasePage（封装通用操作）
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium import webdriver

class BasePage:
    def __init__(self, driver: webdriver.Chrome):
        self.driver = driver
        self.wait = WebDriverWait(driver, 10)  # 显式等待10秒

    # 等待页面标题包含指定文本（验证页面切换）
    def wait_for_title_contains(self, title_text):
        self.wait.until(EC.title_contains(title_text))
        return self

    # 等待元素可点击（通用操作）
    def wait_for_clickable(self, locator):
        return self.wait.until(EC.element_to_be_clickable(locator))

# 2. 登录页类（LoginPage）
class LoginPage(BasePage):
    # 定位器（用户名、密码、登录按钮）
    USERNAME_INPUT = ("id", "username")
    PASSWORD_INPUT = ("id", "password")
    LOGIN_BUTTON = ("xpath", "//button[text()='登录']")

    # 登录操作（跳转至首页）
    def login(self, username, password):
        self.wait_for_clickable(self.USERNAME_INPUT).send_keys(username)
        self.wait_for_clickable(self.PASSWORD_INPUT).send_keys(password)
        self.wait_for_clickable(self.LOGIN_BUTTON).click()
        # 跳转后返回首页实例（链式调用）
        return HomePage(self.driver).wait_for_title_contains("首页")

# 3. 首页类（HomePage）
class HomePage(BasePage):
    # 首页唯一标识（如“我的订单”按钮）
    MY_ORDER_BUTTON = ("xpath", "//a[text()='我的订单']")

    # 验证首页加载完成
    def is_home_page_loaded(self):
        self.wait_for_clickable(self.MY_ORDER_BUTTON)
        return True

# 4. 测试用例（多页面切换）
def test_same_window_switch():
    driver = webdriver.Chrome()
    driver.get("https://xxx.com/login")  # 打开登录页

    # 登录页 → 首页（同一窗口跳转）
    home_page = LoginPage(driver).login("test_user", "123456")
    assert home_page.is_home_page_loaded(), "首页加载失败，页面切换异常"

    driver.quit()

关键技巧：

• 用「页面标题」或「核心元素」作为切换成功的验证条件，比单纯等待更可靠；
• 采用 POM 模式，每个页面类封装自己的定位器和操作，切换页面时直接返回目标页面实例，代码更简洁。

场景 2：新窗口 / 新标签页切换

核心逻辑：

• 浏览器中每个窗口对应一个「句柄（handle）」，切换前先获取所有句柄；
• 对比当前句柄和目标句柄，切换到新窗口后，等待页面加载完成。

实现步骤 + 代码示例：

在 BasePage 中封装窗口切换方法，直接复用：

class BasePage:
    # 新增：切换到新窗口（基于页面标题）
    def switch_to_new_window(self, target_title):
        # 获取当前所有窗口句柄（列表形式）
        all_handles = self.driver.window_handles
        # 遍历所有句柄，切换到目标窗口
        for handle in all_handles:
            self.driver.switch_to.window(handle)
            # 验证窗口标题是否匹配目标页面
            if target_title in self.driver.title:
                self.wait_for_title_contains(target_title)  # 等待页面加载
                return self
        raise Exception(f"未找到标题为【{target_title}】的窗口")

    # 新增：切换回原始窗口
    def switch_to_original_window(self, original_handle):
        self.driver.switch_to.window(original_handle)
        return self

# 测试用例：新标签页切换（首页 → 帮助中心）
def test_new_tab_switch():
    driver = webdriver.Chrome()
    driver.get("https://xxx.com/home")
    home_page = HomePage(driver)

    # 1. 记录原始窗口句柄
    original_handle = driver.current_window_handle

    # 2. 点击“帮助中心”，打开新标签页
    home_page.wait_for_clickable(("xpath", "//a[text()='帮助中心']")).click()

    # 3. 切换到“帮助中心”窗口（目标标题：帮助中心）
    help_page = HelpPage(driver).switch_to_new_window("帮助中心")
    assert "帮助中心" in driver.title, "新窗口切换失败"

    # 4. 操作完成后，切换回原始窗口（首页）
    home_page.switch_to_original_window(original_handle)
    assert "首页" in driver.title, "返回原始窗口失败"

    driver.quit()

关键技巧：

• 切换前务必记录原始窗口句柄，方便后续切回；
• 若新窗口加载慢，在切换后添加显式等待（如等待目标元素），避免元素定位失败；
• 遍历句柄时用「页面标题」或「URL」筛选目标窗口，比索引（如 all_handles[-1]）更稳定（索引可能因窗口打开顺序变化）。

场景 3：iframe/frame 嵌套页面切换

核心问题：

iframe 是独立的 HTML 文档，Selenium 默认上下文是主文档，直接定位 iframe 内的元素会失败，需先切换到 iframe 上下文。

实现步骤 + 代码示例：

在 BasePage 中封装 iframe 切换方法：

class BasePage:
    # 新增：切换到 iframe（支持id/name/xpath定位）
    def switch_to_iframe(self, locator):
        # 等待 iframe 加载完成并切换
        iframe = self.wait.until(EC.frame_to_be_available_and_switch_to_it(locator))
        return self

    # 新增：切回主文档（必须！否则后续主文档元素定位失败）
    def switch_to_default_content(self):
        self.driver.switch_to.default_content()
        return self

# 测试用例：iframe 内登录操作
def test_iframe_switch():
    driver = webdriver.Chrome()
    driver.get("https://xxx.com")  # 主页面包含登录iframe

    # 1. 切换到登录iframe（iframe的id为“login-frame”）
    base_page = BasePage(driver)
    base_page.switch_to_iframe(("id", "login-frame"))

    # 2. 在iframe内执行登录操作（此时定位器作用于iframe内）
    login_page = LoginPage(driver)
    login_page.login("test_user", "123456")

    # 3. 登录完成后，切回主文档
    base_page.switch_to_default_content()

    # 4. 验证主页面元素（如“欢迎语”）
    welcome_text = base_page.wait_for_clickable(("xpath", "//span[text()='欢迎回来']")).text
    assert "欢迎回来" in welcome_text, "iframe切换后操作失败"

    driver.quit()

避坑要点：

• 切换 iframe 后，所有定位操作仅作用于该 iframe，若要操作主文档或其他 iframe，必须先调用 switch_to_default_content()；
• 若 iframe 是动态加载的（如延迟渲染），必须用 EC.frame_to_be_available_and_switch_to_it() 等待，避免 “iframe 未加载完成就切换”；
• 若 iframe 没有 id/name，可用 xpath 定位（如 ("//iframe[@class='xxx']")）。

三、移动端多页面切换实现（Appium + Python）

移动端的 “页面” 对应「Activity」（Android）或「ViewController」（iOS），核心是「等待 Activity 启动 + 验证页面元素」。

核心逻辑：

• Android：通过 appPackage 和 appActivity 识别页面，用 wait_activity() 等待页面切换；
• iOS：通过页面标题或核心元素验证，用 mobile: waitFor 或显式等待。

实现步骤 + 代码示例（Android）：

from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# 1. Desired Capabilities 配置
desired_caps = {
    "platformName": "Android",
    "deviceName": "emulator-5554",
    "appPackage": "com.xxx.app",  # 应用包名
    "appActivity": ".ui.LoginActivity",  # 启动Activity（登录页）
    "noReset": True  # 不重置应用状态
}

# 2. 测试用例：登录页 → 首页（Activity切换）
def test_app_activity_switch():
    driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)
    wait = WebDriverWait(driver, 15)

    # 1. 登录页操作（输入用户名、密码、点击登录）
    wait.until(EC.element_to_be_clickable((AppiumBy.ID, "com.xxx.app:id/et_username"))).send_keys("test_user")
    wait.until(EC.element_to_be_clickable((AppiumBy.ID, "com.xxx.app:id/et_password"))).send_keys("123456")
    wait.until(EC.element_to_be_clickable((AppiumBy.ID, "com.xxx.app:id/btn_login"))).click()

    # 2. 等待首页Activity启动（首页Activity：.ui.HomeActivity）
    driver.wait_activity(".ui.HomeActivity", 10)  # 等待10秒，超时则报错

    # 3. 验证首页元素（如“我的”图标）
    home_tab = wait.until(EC.element_to_be_clickable((AppiumBy.XPATH, "//*[@text='我的']")))
    assert home_tab.is_displayed(), "首页切换失败"

    driver.quit()

关键技巧：

• Android 中通过 adb shell dumpsys window | grep mCurrentFocus 可获取当前 Activity（调试用）；
• 若页面是 Fragment 切换（同一 Activity 内），需通过页面核心元素验证（如底部 Tab 的选中状态），而非 Activity。

四、通用避坑指南（必看！）

1. 拒绝硬等待（time.sleep ()）：一律用显式等待（WebDriverWait），基于 “元素可点击”“页面标题匹配” 等条件，适配不同网络 / 设备速度；
2. 切换后必验证：每次切换页面（窗口 /iframe/Activity）后，必须验证目标页面的特征（元素 / 标题 / Activity），避免 “假切换”；
3. 上下文还原：切换 iframe / 新窗口后，若后续需要操作原上下文，务必切回（switch_to_default_content()/switch_to_original_window()）；
4. 定位器稳定性：优先用 id/accessibility_id 定位元素，避免 xpath 依赖页面结构（如 //div[3]/span[2]），减少页面切换后定位器失效；
5. 处理弹窗干扰：页面切换时可能出现广告弹窗、权限弹窗，需在 BasePage 中封装弹窗处理逻辑（如 “自动关闭弹窗”），避免阻塞切换流程。

五、实战拓展：多页面切换的自动化框架优化

在实际项目中，可进一步封装「页面切换管理器」，统一处理所有场景，提升代码复用性：

class PageSwitchManager:
    """页面切换管理器，统一处理窗口、iframe、Activity切换"""
    def __init__(self, driver):
        self.driver = driver
        self.wait = WebDriverWait(driver, 10)

    # 1. 同一窗口页面跳转
    def switch_same_window(self, target_title):
        self.wait.until(EC.title_contains(target_title))
        return self

    # 2. 新窗口切换
    def switch_new_window(self, target_title, original_handle=None):
        for handle in self.driver.window_handles:
            self.driver.switch_to.window(handle)
            if target_title in self.driver.title:
                self.switch_same_window(target_title)
                return self, handle  # 返回新窗口句柄
        raise Exception(f"未找到目标窗口：{target_title}")

    # 3. iframe切换
    def switch_iframe(self, locator):
        self.wait.until(EC.frame_to_be_available_and_switch_to_it(locator))
        return self

    # 4. 还原上下文（主文档+原始窗口）
    def restore_context(self, original_handle):
        self.driver.switch_to.default_content()
        self.driver.switch_to.window(original_handle)
        return self

使用时直接调用管理器，无需重复编写切换逻辑，适配复杂项目的多页面场景。

总结

多页面切换的核心是「明确上下文 + 等待就绪 + 验证结果」，不同场景的实现重点不同，但都需遵循 “稳定、可复用” 原则：

• Web 端：重点处理窗口句柄、iframe 上下文，结合 POM 模式封装；
• 移动端：重点等待 Activity 启动，用元素验证 Fragment 切换；
• 通用技巧：显式等待是基础，切换后必验证，上下文及时还原。