blob: e09eb2fbbe5eb1e45f9c675b13dc259ff442ca02 [file] [log] [blame]
// Copyright (c) 2009 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#pragma once
#include <string>
#include "testing/gtest/include/gtest/gtest.h"
#include "v8/include/v8.h"
namespace base {
class StringPiece;
// A superclass for unit tests that involve running JavaScript. This class
// sets up V8 context and has methods that make it easy to execute scripts in
// this context as well as call functions in the context.
class V8UnitTest : public testing::Test {
virtual ~V8UnitTest();
virtual void SetUp();
// Executes the given script source in the context. The specified script
// name is used when reporting errors.
virtual void ExecuteScriptInContext(const base::StringPiece& script_source,
const base::StringPiece& script_name);
// Set a variable to a string value in the global scope.
virtual void SetGlobalStringVar(const std::string& var_name,
const std::string& value);
// Converts a v8::TryCatch into a human readable string.
virtual std::string ExceptionToString(v8::TryCatch* try_catch);
// Calls the specified function that resides in the global scope of the
// context. If the function throws an exception, FAIL() is called to
// indicate a unit test failure. This is useful for executing unit test
// functions implemented in JavaScript.
virtual void TestFunction(const std::string& function_name);
// This method is bound to a global function "log" in the context.
// Scripts running in the context can call this to print out logging
// information to the console.
static v8::Handle<v8::Value> Log(const v8::Arguments& args);
// Handle scope that is used throughout the life of this class.
v8::HandleScope handle_scope_;
// Context for the JavaScript in the test.
v8::Handle<v8::Context> context_;