医院网站建设课程代码,山东省城乡住房和建设厅网站,python做网站入门,wordpress主题dux1.9剧作家可以为页面 DOM 元素或页面内的任何其他对象创建句柄。这些句柄存在于 Playwright 进程中#xff0c;而实际对象位于浏览器中。有两种类型的句柄#xff1a;
JSHandle 引用页面中的任何 JavaScript 对象ElementHandle 引用页面中的 DOM 元素#xff0c;它具有额外的方…剧作家可以为页面 DOM 元素或页面内的任何其他对象创建句柄。这些句柄存在于 Playwright 进程中而实际对象位于浏览器中。有两种类型的句柄
JSHandle 引用页面中的任何 JavaScript 对象ElementHandle 引用页面中的 DOM 元素它具有额外的方法允许对元素执行操作并断言其属性。
由于页面中的任何 DOM 元素也是 JavaScript 对象因此任何 ElementHandle 也是 JSHandle。
句柄用于对页面中的这些实际对象执行操作。可以在句柄上求值、获取句柄属性、将句柄作为求值参数传递、将页面对象序列化为 JSON 等。有关这些和方法请参阅 JSHandle 类 API。
元素句柄 不鼓励使用 ElementHandle请改用定位器对象和 Web 优先断言。 当需要 ElementHandle 时建议使用 page.wait_for_selector 或 frame.wait_for_selector 方法获取它。这些 API 等待元素附加并可见。
# Get the element handle
element_handle page.wait_for_selector(#box)# Assert bounding box for the element
bounding_box element_handle.bounding_box()
assert bounding_box.width 100# Assert attribute for the element
class_names element_handle.get_attribute(class)
assert highlighted in class_names
句柄作为参数
句柄可以传递到 page.evaluate 和类似的方法中。以下代码片段在页面中创建一个新数组使用数据对其进行初始化并将此数组的句柄返回到 Playwright。然后它在后续评估中使用该句柄
# Create new array in page.
my_array_handle page.evaluate_handle(() {window.myArray [1];return myArray;
})# Get current length of the array.
length page.evaluate(a a.length, my_array_handle)# Add one more element to the array using the handle
page.evaluate((arg) arg.myArray.push(arg.newElement), {myArray: my_array_handle,newElement: 2
})# Release the object when its no longer needed.
my_array_handle.dispose()
处理生命周期
可以使用页面方法如 page.evaluate_handle、page.query_selector 或 page.query_selector_all 或其框架对应项 frame.evaluate_handle、frame.query_selector 或 frame.query_selector_all 获取句柄。创建后句柄将保留垃圾回收中的对象除非页面导航或通过 js_handle.dispose 方法手动处置句柄。
定位器 vs 元素手柄 我们只建议在极少数情况下使用 ElementHandle当你需要在静态页面上执行大量的 DOM 遍历时。对于所有用户操作和断言请改用定位器。 定位器和 ElementHandle 之间的区别在于后者指向特定元素而定位器捕获如何检索该元素的逻辑。
在下面的示例中句柄指向页面上的特定 DOM 元素。如果该元素更改文本或被 React 用于渲染完全不同的组件句柄仍然指向那个非常陈旧的 DOM 元素。这可能会导致意外行为。
handle page.query_selector(textSubmit)
handle.hover()
handle.click()
使用定位器时每次使用定位器时最新的 DOM 元素都会使用选择器位于页面中。因此在下面的代码片段中底层 DOM 元素将被定位两次。 locator page.get_by_text(Submit) locator.hover() locator.click()