issue - #3655

lib/api/protocol/frame.js

@@ -28,7 +28,6 @@ const ProtocolAction = require('./_base-action.js');
  * @api protocol.frames
  */
 const findElement = function(selector) {
-
   return new Promise((resolve, reject) => {
     this.api.findElement({selector, suppressNotFoundErrors: true}, function(res) {
       if (res.status === -1 && res.error) {
@@ -52,7 +51,17 @@ module.exports = class Session extends ProtocolAction {
       return this.transportActions.switchToFrame(callback);
     }
 
-    if (typeof frameId == 'string') {
+    // Check if frameId is a page object element by checking if it starts with "@"
+    if (typeof frameId === 'string' && frameId.startsWith('@')) {
+      // Resolve the page object selector to an actual CSS selector
+      frameId = await this.api.resolveElement(frameId)
+        .catch(err => {
+          throw new Error(`Unable to resolve page object selector ${frameId}.`);
+        });
+    }
+
+    // Proceed with finding the frame element using the resolved selector
+    if (typeof frameId === 'string') {
       frameId = await findElement.call(this, frameId)
         .catch(err => {
           return findElement.call(this, `*[name="${frameId}"]`);

types/index.d.ts

@@ -7950,4 +7950,4 @@ declare global {
   const ensure: Ensure;
   const expect: Expect;
   const locateWith: typeof seleniumLocateWith;
-}
+}