001/*
002 * (C) Copyright 2006-2011 Nuxeo SA (http://nuxeo.com/) and others.
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 *     http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 * See the License for the specific language governing permissions and
014 * limitations under the License.
015 * 
016 * Contributors:
017 */
018
019package org.openqa.selenium.support.ui;
020
021import org.openqa.selenium.WebDriver;
022
023import com.google.common.base.Function;
024
025/**
026 * Models a condition that might reasonably be expected to eventually evaluate to something that is neither null nor
027 * false. Examples would include determining if a web page has loaded or that an element is visible.
028 * <p>
029 * Note that it is expected that ExpectedConditions are idempotent. They will be called in a loop by the
030 * {@link WebDriverWait} and any modification of the state of the application under test may have unexpected
031 * side-effects.
032 *
033 * @param <T> The return type
034 */
035public interface ExpectedCondition<T> extends Function<WebDriver, T> {
036}