findNamed(_:)
Returns a web frame that matches the given name.
Declaration
func findNamed(_ name: String!) -> WebFrame!Parameters
- name:
The name of a frame.
Return Value
For predefined names, returns the receiver if name is “_self” or “_current”, returns the receiver’s parent frame if name is “_parent”, and returns the main frame if name is “_top”. Also returns the receiver if it is the main frame and name is either “_parent” or “_top.” For other names, this method returns the first frame that matches name. Returns nil if no match is found.
Discussion
This method searches the receiver and its descendants first, then the receiver’s parent and its children moving up the hierarchy until a match is found. If no match is found in the receivers hierarchy, this method will search for a matching frame in other main frame hierarchies.