/* * Copyright (C) 2017 Igalia S.L. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF * THE POSSIBILITY OF SUCH DAMAGE. */ #pragma once #include #include #include namespace WebDriver { class CommandResult { public: // ยง6.6 Handling Errors. // https://www.w3.org/TR/webdriver/#handling-errors enum class ErrorCode { ElementClickIntercepted, ElementNotSelectable, ElementNotInteractable, InvalidArgument, InvalidElementState, InvalidSelector, InvalidSessionID, JavascriptError, MoveTargetOutOfBounds, NoSuchAlert, NoSuchCookie, NoSuchElement, NoSuchFrame, NoSuchWindow, ScriptTimeout, SessionNotCreated, StaleElementReference, Timeout, UnableToCaptureScreen, UnexpectedAlertOpen, UnknownCommand, UnknownError, UnsupportedOperation, }; static CommandResult success(RefPtr&& result = nullptr) { return CommandResult(WTFMove(result)); } static CommandResult fail(RefPtr&& result = nullptr) { return CommandResult(WTFMove(result), CommandResult::ErrorCode::UnknownError); } static CommandResult fail(ErrorCode errorCode, std::optional errorMessage = std::nullopt) { return CommandResult(errorCode, errorMessage); } unsigned httpStatusCode() const; const RefPtr& result() const { return m_result; }; void setAdditionalErrorData(RefPtr&& errorData) { m_errorAdditionalData = WTFMove(errorData); } bool isError() const { return !!m_errorCode; } ErrorCode errorCode() const { ASSERT(isError()); return m_errorCode.value(); } String errorString() const; std::optional errorMessage() const { ASSERT(isError()); return m_errorMessage; } const RefPtr& additionalErrorData() const { return m_errorAdditionalData; } private: explicit CommandResult(RefPtr&&, std::optional = std::nullopt); explicit CommandResult(ErrorCode, std::optional = std::nullopt); RefPtr m_result; std::optional m_errorCode; std::optional m_errorMessage; RefPtr m_errorAdditionalData; }; } // namespace WebDriver