blob: 1ecb7bf0b61a3a219ed14fdaa2004c1d9b9c0226 [file] [log] [blame]
// Copyright 2017 Google Inc. All Rights Reserved.
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// See the License for the specific language governing permissions and
// limitations under the License.
import '../common/by.dart';
import '../common/request_client.dart';
import '../common/webdriver_handler.dart';
import 'alert.dart';
import 'web_driver.dart';
import 'web_element.dart';
import 'window.dart';
class TargetLocator {
final WebDriver _driver;
final SyncRequestClient _client;
final WebDriverHandler _handler;
TargetLocator(this._driver, this._client, this._handler);
/// Changes focus to another frame on the page.
/// If [frame] is a:
/// [int]: select by its zero-based index
/// [WebElement]: select the frame for a previously found frame or iframe
/// element.
/// [String]: same as above, but only CSS id is provided. Note that this
/// is not element id or frame id.
/// not provided: selects the first frame on the page or the main document.
/// Throws [NoSuchFrameException] if the specified frame can't be found.
void frame([/* int | WebElement | String */ frame]) {
if (frame is int?) {
} else if (frame is WebElement) {
} else if (frame is String) {
final frameId = _driver.findElement(;
} else {
throw 'Unsupported frame "$frame" with type ${frame.runtimeType}';
/// Changes focus to the parent frame of the current one.
void parentFrame() {
/// Switches the focus of void commands for this driver to the window with the
/// given name/handle.
/// Throws [NoSuchWindowException] if the specified window can't be found.
void window(Window window) {
/// Switches to the currently active modal dialog for this particular driver
/// instance.
/// In implementation, just getting alert won't trigger anything. Call
/// `alert.text` or other action to really switch to alert.
Alert get alert => Alert(_client, _handler);
String toString() => '$_driver.switchTo';
int get hashCode => _driver.hashCode;
bool operator ==(other) => other is TargetLocator && other._driver == _driver;