本文介绍一种实用的 selenium 自动化方案，通过模拟键盘操作（keys.down）逐项触发 power bi 动态加载的下拉菜单选项，并准确提取所有可见类别名称，适用于“municipio”等惰性渲染型筛选器。
本文介绍一种实用的 selenium 自动化方案，通过模拟键盘操作（keys.down）逐项触发 power bi 动态加载的下拉菜单选项，并准确提取所有可见类别名称，适用于“municipio”等惰性渲染型筛选器。
在 Power BI 嵌入式报表中，许多下拉筛选器（如 aria-label="MUNICIPIO"）采用虚拟滚动（virtual scrolling）或按需渲染（lazy rendering）机制：初始 HTML 仅包含当前可视区域的少量选项，其余选项仅在用户滚动或聚焦时动态注入 DOM。这导致传统 find_elements(By.XPATH, "//div[@class='pbi-menu-item-text-container']") 方法无法一次性获取全部条目——这也是你遇到“只显示部分选项”的根本原因。
针对该限制，推荐采用键盘导航 + 状态轮询策略：先激活下拉菜单，再持续发送 Keys.DOWN 触发焦点下移，每次捕获当前高亮项的文本，直至循环回到首个选项（检测重复即视为遍历完成）。该方法不依赖完整 DOM 加载，兼容 Power BI Web 的交互逻辑。
以下为完整可运行示例（已适配最新 Selenium 4+ API）：
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.common.keys import Keys
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
import time
# 初始化驱动（建议使用 WebDriver Manager 自动管理 chromedriver）
driver = webdriver.Chrome()
wait = WebDriverWait(driver, 20)
try:
url = "https://app.powerbi.com/view?r=eyJrIjoiYjQ1NTA2OTYtYTNkMi00ZTM4LWI2ODUtZjE0MTdhODg2OWU3IiwidCI6IjU2YzFlMmZiLTg3YzEtNGRlMC1hNmFjLWQwNTY2YzA4Y2U2NiJ9"
driver.get(url)
# 步骤1：定位并点击下拉触发器（确保元素可交互）
dropdown_trigger = wait.until(
EC.element_to_be_clickable((By.XPATH, "//div[@aria-label='MUNICIPIO']"))
)
dropdown_trigger.click()
# 步骤2：等待首个可聚焦项出现（Power BI 通常用 'slicerItemContainer' 类标识）
first_item = wait.until(
EC.visibility_of_element_located((By.XPATH, "//div[contains(@class, 'slicerItemContainer')]"))
)
first_item.send_keys(Keys.DOWN) # 初始触发焦点移动，避免首项重复
# 步骤3：循环遍历所有选项
options = []
while True:
# 定位当前高亮项（Power BI 高亮时会添加 'setFocusRing' 类）
current = wait.until(
EC.visibility_of_element_located((By.XPATH, "//div[contains(@class, 'slicerItemContainer') and contains(@class, 'setFocusRing')]"))
)
text = current.text.strip()
# 检测循环结束：若文本为空或与首个有效项重复，则终止
if not text or (options and options[0] == text):
break
options.append(text)
# 发送 DOWN 键并短暂等待 UI 响应（关键！避免读取滞后）
current.send_keys(Keys.DOWN)
time.sleep(0.15) # 根据网络/渲染性能调整，0.1–0.3 秒较稳妥
print(f"成功提取 {len(options)} 个 MUNICIPIO 选项：")
for i, opt in enumerate(options, 1):
print(f"{i}. {opt}")
finally:
driver.quit()✅ 关键注意事项：
- time.sleep() 不可省略：Power BI 渲染存在微小延迟，过快读取会导致 current.text 返回旧值或空字符串；实测 0.15s 在多数网络环境下稳定可靠。
- 精准定位高亮元素：使用 contains(@class, 'setFocusRing') 比硬编码 data-row-index 更健壮（后者在动态列表中易失效）。
- 异常防护：实际部署时建议增加 try/except 捕获 StaleElementReferenceException（元素被重绘），并在循环内重新定位 current 元素。
- 替代方案提示：若页面允许，可尝试监听 MutationObserver 或等待 div[role="option"] 出现，但键盘导航法普适性更强，无需深入 Power BI 内部 DOM 结构。
此方法已在多个 Power BI 报表中验证有效，兼顾稳定性与开发效率。掌握该模式后，可快速迁移至其他类似惰性加载组件（如 Azure Synapse、Tableau Web）的自动化测试场景。
