| Library scope: | GLOBAL |
|---|
Robot keyword Resource for catching a later failure in temporarily passing repeated check.
Copyright (c) 2015-2017 Cisco Systems, Inc. and others. All rights reserved.
This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html
Terminology: "cell_sequence" is a sequence of Robot cells, usually executable. "keyword_name" is a first cell in that sequence, entry point of execution, the item defined in Keywords table (or in a Library or Resource) which may take arguments (the rest of cell sequence). Note that this may not work correctly with named arguments, due to ordering, so positional cells are strongly suggested to be positional arguments. "Keyword" or "keyword" may refer to keyword_name or executable cell sequence, or both, depending on context.
Some Keywords need several tries to finally fail, this keyword passes if and only if the failure ultimately happens.
The response of Keyword execution is either a return value or a failure message. This keyword calls the argument keyword and returns its failure message string, or fails with its return value converted to string.
Try to run the Keyword and Log the result. Pass and return the error on any failure, Fail otherwise. Deprecated, was used in previous implementation of higher-level keywords.
Execute failable Keyword. Log the resulting value when it does not fail. Deprecated, was used in previous implementation of higher-level keywords.
Some positive checks report false success for a short time. This keyword verifies no failure does happen within timeout period. This implementation needs more complicated logic than, Verify_Keyword_Never_Passes_Within_Timeout, so use that keyword in case you have a negative check handy.
Some negative checks report false failure for a short time. This keyword verifies no pass does happen within timeout period.