// Copyright 2008 the V8 project authors. All rights reserved. // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * 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. // * Neither the name of Google Inc. nor the names of its // contributors may be used to endorse or promote products derived // from this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND 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 THE COPYRIGHT // OWNER OR 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. #ifndef CCTEST_H_ #define CCTEST_H_ #include "include/libplatform/libplatform.h" #include "src/v8.h" #ifndef TEST #define TEST(Name) \ static void Test##Name(); \ CcTest register_test_##Name(Test##Name, __FILE__, #Name, NULL, true, true); \ static void Test##Name() #endif #ifndef UNINITIALIZED_TEST #define UNINITIALIZED_TEST(Name) \ static void Test##Name(); \ CcTest register_test_##Name(Test##Name, __FILE__, #Name, NULL, true, false); \ static void Test##Name() #endif #ifndef DEPENDENT_TEST #define DEPENDENT_TEST(Name, Dep) \ static void Test##Name(); \ CcTest register_test_##Name(Test##Name, __FILE__, #Name, #Dep, true, true); \ static void Test##Name() #endif #ifndef UNINITIALIZED_DEPENDENT_TEST #define UNINITIALIZED_DEPENDENT_TEST(Name, Dep) \ static void Test##Name(); \ CcTest register_test_##Name(Test##Name, __FILE__, #Name, #Dep, true, false); \ static void Test##Name() #endif #ifndef DISABLED_TEST #define DISABLED_TEST(Name) \ static void Test##Name(); \ CcTest register_test_##Name(Test##Name, __FILE__, #Name, NULL, false, true); \ static void Test##Name() #endif #define EXTENSION_LIST(V) \ V(GC_EXTENSION, "v8/gc") \ V(PRINT_EXTENSION, "v8/print") \ V(PROFILER_EXTENSION, "v8/profiler") \ V(TRACE_EXTENSION, "v8/trace") #define DEFINE_EXTENSION_ID(Name, Ident) Name##_ID, enum CcTestExtensionIds { EXTENSION_LIST(DEFINE_EXTENSION_ID) kMaxExtensions }; #undef DEFINE_EXTENSION_ID typedef v8::internal::EnumSet CcTestExtensionFlags; #define DEFINE_EXTENSION_FLAG(Name, Ident) \ static const CcTestExtensionFlags Name(1 << Name##_ID); static const CcTestExtensionFlags NO_EXTENSIONS(0); static const CcTestExtensionFlags ALL_EXTENSIONS((1 << kMaxExtensions) - 1); EXTENSION_LIST(DEFINE_EXTENSION_FLAG) #undef DEFINE_EXTENSION_FLAG // Use this to expose protected methods in i::Heap. class TestHeap : public i::Heap { public: using i::Heap::AllocateByteArray; using i::Heap::AllocateFixedArray; using i::Heap::AllocateHeapNumber; using i::Heap::AllocateFloat32x4; using i::Heap::AllocateJSObject; using i::Heap::AllocateJSObjectFromMap; using i::Heap::AllocateMap; using i::Heap::CopyCode; using i::Heap::kInitialNumberStringCacheSize; }; class CcTest { public: typedef void (TestFunction)(); CcTest(TestFunction* callback, const char* file, const char* name, const char* dependency, bool enabled, bool initialize); void Run(); static CcTest* last() { return last_; } CcTest* prev() { return prev_; } const char* file() { return file_; } const char* name() { return name_; } const char* dependency() { return dependency_; } bool enabled() { return enabled_; } static v8::Isolate* isolate() { CHECK(isolate_ != NULL); v8::base::NoBarrier_Store(&isolate_used_, 1); return isolate_; } static i::Isolate* InitIsolateOnce() { if (!initialize_called_) InitializeVM(); return i_isolate(); } static i::Isolate* i_isolate() { return reinterpret_cast(isolate()); } static i::Heap* heap() { return i_isolate()->heap(); } static TestHeap* test_heap() { return reinterpret_cast(i_isolate()->heap()); } static v8::base::RandomNumberGenerator* random_number_generator() { return InitIsolateOnce()->random_number_generator(); } static v8::Local global() { return isolate()->GetCurrentContext()->Global(); } static v8::ArrayBuffer::Allocator* array_buffer_allocator() { return allocator_; } static void set_array_buffer_allocator( v8::ArrayBuffer::Allocator* allocator) { allocator_ = allocator; } // TODO(dcarney): Remove. // This must be called first in a test. static void InitializeVM() { CHECK(!v8::base::NoBarrier_Load(&isolate_used_)); CHECK(!initialize_called_); initialize_called_ = true; v8::HandleScope handle_scope(CcTest::isolate()); v8::Context::New(CcTest::isolate())->Enter(); } // Only for UNINITIALIZED_TESTs static void DisableAutomaticDispose(); // Helper function to configure a context. // Must be in a HandleScope. static v8::Local NewContext( CcTestExtensionFlags extensions, v8::Isolate* isolate = CcTest::isolate()); static void TearDown() { if (isolate_ != NULL) isolate_->Dispose(); } private: friend int main(int argc, char** argv); TestFunction* callback_; const char* file_; const char* name_; const char* dependency_; bool enabled_; bool initialize_; CcTest* prev_; static CcTest* last_; static v8::ArrayBuffer::Allocator* allocator_; static v8::Isolate* isolate_; static bool initialize_called_; static v8::base::Atomic32 isolate_used_; }; // Switches between all the Api tests using the threading support. // In order to get a surprising but repeatable pattern of thread // switching it has extra semaphores to control the order in which // the tests alternate, not relying solely on the big V8 lock. // // A test is augmented with calls to ApiTestFuzzer::Fuzz() in its // callbacks. This will have no effect when we are not running the // thread fuzzing test. In the thread fuzzing test it will // pseudorandomly select a successor thread and switch execution // to that thread, suspending the current test. class ApiTestFuzzer: public v8::base::Thread { public: void CallTest(); // The ApiTestFuzzer is also a Thread, so it has a Run method. virtual void Run(); enum PartOfTest { FIRST_PART, SECOND_PART, THIRD_PART, FOURTH_PART, LAST_PART = FOURTH_PART }; static void SetUp(PartOfTest part); static void RunAllTests(); static void TearDown(); // This method switches threads if we are running the Threading test. // Otherwise it does nothing. static void Fuzz(); private: explicit ApiTestFuzzer(int num) : Thread(Options("ApiTestFuzzer")), test_number_(num), gate_(0), active_(true) {} ~ApiTestFuzzer() {} static bool fuzzing_; static int tests_being_run_; static int current_; static int active_tests_; static bool NextThread(); int test_number_; v8::base::Semaphore gate_; bool active_; void ContextSwitch(); static int GetNextTestNumber(); static v8::base::Semaphore all_tests_done_; }; #define THREADED_TEST(Name) \ static void Test##Name(); \ RegisterThreadedTest register_##Name(Test##Name, #Name); \ /* */ TEST(Name) class RegisterThreadedTest { public: explicit RegisterThreadedTest(CcTest::TestFunction* callback, const char* name) : fuzzer_(NULL), callback_(callback), name_(name) { prev_ = first_; first_ = this; count_++; } static int count() { return count_; } static RegisterThreadedTest* nth(int i) { CHECK(i < count()); RegisterThreadedTest* current = first_; while (i > 0) { i--; current = current->prev_; } return current; } CcTest::TestFunction* callback() { return callback_; } ApiTestFuzzer* fuzzer_; const char* name() { return name_; } private: static RegisterThreadedTest* first_; static int count_; CcTest::TestFunction* callback_; RegisterThreadedTest* prev_; const char* name_; }; // A LocalContext holds a reference to a v8::Context. class LocalContext { public: LocalContext(v8::Isolate* isolate, v8::ExtensionConfiguration* extensions = 0, v8::Handle global_template = v8::Handle(), v8::Handle global_object = v8::Handle()) { Initialize(isolate, extensions, global_template, global_object); } LocalContext(v8::ExtensionConfiguration* extensions = 0, v8::Handle global_template = v8::Handle(), v8::Handle global_object = v8::Handle()) { Initialize(CcTest::isolate(), extensions, global_template, global_object); } virtual ~LocalContext() { v8::HandleScope scope(isolate_); v8::Local::New(isolate_, context_)->Exit(); context_.Reset(); } v8::Context* operator->() { return *reinterpret_cast(&context_); } v8::Context* operator*() { return operator->(); } bool IsReady() { return !context_.IsEmpty(); } v8::Local local() { return v8::Local::New(isolate_, context_); } private: void Initialize(v8::Isolate* isolate, v8::ExtensionConfiguration* extensions, v8::Handle global_template, v8::Handle global_object) { v8::HandleScope scope(isolate); v8::Local context = v8::Context::New(isolate, extensions, global_template, global_object); context_.Reset(isolate, context); context->Enter(); // We can't do this later perhaps because of a fatal error. isolate_ = isolate; } v8::Persistent context_; v8::Isolate* isolate_; }; static inline uint16_t* AsciiToTwoByteString(const char* source) { int array_length = i::StrLength(source) + 1; uint16_t* converted = i::NewArray(array_length); for (int i = 0; i < array_length; i++) converted[i] = source[i]; return converted; } static inline v8::Local v8_num(double x) { return v8::Number::New(v8::Isolate::GetCurrent(), x); } static inline v8::Local v8_str(const char* x) { return v8::String::NewFromUtf8(v8::Isolate::GetCurrent(), x); } static inline v8::Local v8_symbol(const char* name) { return v8::Symbol::New(v8::Isolate::GetCurrent(), v8_str(name)); } static inline v8::Local v8_compile(const char* x) { return v8::Script::Compile(v8_str(x)); } static inline v8::Local v8_compile(v8::Local x) { return v8::Script::Compile(x); } static inline v8::Local CompileWithOrigin( v8::Local source, v8::Local origin_url) { v8::ScriptOrigin origin(origin_url); v8::ScriptCompiler::Source script_source(source, origin); return v8::ScriptCompiler::Compile( v8::Isolate::GetCurrent(), &script_source); } static inline v8::Local CompileWithOrigin( v8::Local source, const char* origin_url) { return CompileWithOrigin(source, v8_str(origin_url)); } static inline v8::Local CompileWithOrigin(const char* source, const char* origin_url) { return CompileWithOrigin(v8_str(source), v8_str(origin_url)); } // Helper functions that compile and run the source. static inline v8::Local CompileRun(const char* source) { return v8::Script::Compile(v8_str(source))->Run(); } // Helper functions that compile and run the source. static inline v8::MaybeLocal CompileRun( v8::Local context, const char* source) { return v8::Script::Compile(v8_str(source))->Run(context); } // Compiles source as an ES6 module. static inline v8::Local CompileRunModule(const char* source) { v8::ScriptCompiler::Source script_source(v8_str(source)); return v8::ScriptCompiler::CompileModule(v8::Isolate::GetCurrent(), &script_source)->Run(); } static inline v8::Local CompileRun(v8::Local source) { return v8::Script::Compile(source)->Run(); } static inline v8::Local ParserCacheCompileRun(const char* source) { // Compile once just to get the preparse data, then compile the second time // using the data. v8::Isolate* isolate = v8::Isolate::GetCurrent(); v8::ScriptCompiler::Source script_source(v8_str(source)); v8::ScriptCompiler::Compile(isolate, &script_source, v8::ScriptCompiler::kProduceParserCache); // Check whether we received cached data, and if so use it. v8::ScriptCompiler::CompileOptions options = script_source.GetCachedData() ? v8::ScriptCompiler::kConsumeParserCache : v8::ScriptCompiler::kNoCompileOptions; return v8::ScriptCompiler::Compile(isolate, &script_source, options)->Run(); } // Helper functions that compile and run the source with given origin. static inline v8::Local CompileRunWithOrigin(const char* source, const char* origin_url, int line_number, int column_number) { v8::Isolate* isolate = v8::Isolate::GetCurrent(); v8::ScriptOrigin origin(v8_str(origin_url), v8::Integer::New(isolate, line_number), v8::Integer::New(isolate, column_number)); v8::ScriptCompiler::Source script_source(v8_str(source), origin); return v8::ScriptCompiler::Compile(isolate, &script_source)->Run(); } static inline v8::Local CompileRunWithOrigin( v8::Local source, const char* origin_url) { v8::ScriptCompiler::Source script_source( source, v8::ScriptOrigin(v8_str(origin_url))); return v8::ScriptCompiler::Compile(v8::Isolate::GetCurrent(), &script_source) ->Run(); } static inline v8::Local CompileRunWithOrigin( const char* source, const char* origin_url) { return CompileRunWithOrigin(v8_str(source), origin_url); } static inline void ExpectString(const char* code, const char* expected) { v8::Local result = CompileRun(code); CHECK(result->IsString()); v8::String::Utf8Value utf8(result); CHECK_EQ(0, strcmp(expected, *utf8)); } static inline void ExpectInt32(const char* code, int expected) { v8::Local result = CompileRun(code); CHECK(result->IsInt32()); CHECK_EQ(expected, result->Int32Value()); } static inline void ExpectBoolean(const char* code, bool expected) { v8::Local result = CompileRun(code); CHECK(result->IsBoolean()); CHECK_EQ(expected, result->BooleanValue()); } static inline void ExpectTrue(const char* code) { ExpectBoolean(code, true); } static inline void ExpectFalse(const char* code) { ExpectBoolean(code, false); } static inline void ExpectObject(const char* code, v8::Local expected) { v8::Local result = CompileRun(code); CHECK(result->SameValue(expected)); } static inline void ExpectUndefined(const char* code) { v8::Local result = CompileRun(code); CHECK(result->IsUndefined()); } // Helper function that simulates a full new-space in the heap. static inline bool FillUpOnePage(v8::internal::NewSpace* space) { v8::internal::AllocationResult allocation = space->AllocateRawUnaligned( v8::internal::Page::kMaxRegularHeapObjectSize); if (allocation.IsRetry()) return false; v8::internal::HeapObject* free_space = NULL; CHECK(allocation.To(&free_space)); space->heap()->CreateFillerObjectAt( free_space->address(), v8::internal::Page::kMaxRegularHeapObjectSize); return true; } // Helper function that simulates a fill new-space in the heap. static inline void AllocateAllButNBytes(v8::internal::NewSpace* space, int extra_bytes) { int space_remaining = static_cast(*space->allocation_limit_address() - *space->allocation_top_address()); CHECK(space_remaining >= extra_bytes); int new_linear_size = space_remaining - extra_bytes; if (new_linear_size == 0) return; v8::internal::AllocationResult allocation = space->AllocateRawUnaligned(new_linear_size); v8::internal::HeapObject* free_space = NULL; CHECK(allocation.To(&free_space)); space->heap()->CreateFillerObjectAt(free_space->address(), new_linear_size); } static inline void FillCurrentPage(v8::internal::NewSpace* space) { AllocateAllButNBytes(space, 0); } static inline void SimulateFullSpace(v8::internal::NewSpace* space) { FillCurrentPage(space); while (FillUpOnePage(space)) { } } // Helper function that simulates a full old-space in the heap. static inline void SimulateFullSpace(v8::internal::PagedSpace* space) { space->EmptyAllocationInfo(); space->ResetFreeList(); space->ClearStats(); } // Helper function that simulates many incremental marking steps until // marking is completed. static inline void SimulateIncrementalMarking(i::Heap* heap) { i::MarkCompactCollector* collector = heap->mark_compact_collector(); i::IncrementalMarking* marking = heap->incremental_marking(); if (collector->sweeping_in_progress()) { collector->EnsureSweepingCompleted(); } CHECK(marking->IsMarking() || marking->IsStopped()); if (marking->IsStopped()) { marking->Start(i::Heap::kNoGCFlags); } CHECK(marking->IsMarking()); while (!marking->IsComplete()) { marking->Step(i::MB, i::IncrementalMarking::NO_GC_VIA_STACK_GUARD); if (marking->IsReadyToOverApproximateWeakClosure()) { marking->MarkObjectGroups(); } } CHECK(marking->IsComplete()); } static void DummyDebugEventListener( const v8::Debug::EventDetails& event_details) {} static inline void EnableDebugger() { v8::Debug::SetDebugEventListener(&DummyDebugEventListener); } static inline void DisableDebugger() { v8::Debug::SetDebugEventListener(NULL); } static inline void EmptyMessageQueues(v8::Isolate* isolate) { while (v8::platform::PumpMessageLoop(v8::internal::V8::GetCurrentPlatform(), isolate)) ; } // Helper class for new allocations tracking and checking. // To use checking of JS allocations tracking in a test, // just create an instance of this class. class HeapObjectsTracker { public: HeapObjectsTracker() { heap_profiler_ = i::Isolate::Current()->heap_profiler(); CHECK_NOT_NULL(heap_profiler_); heap_profiler_->StartHeapObjectsTracking(true); } ~HeapObjectsTracker() { i::Isolate::Current()->heap()->CollectAllAvailableGarbage(); CHECK_EQ(0, heap_profiler_->heap_object_map()->FindUntrackedObjects()); heap_profiler_->StopHeapObjectsTracking(); } private: i::HeapProfiler* heap_profiler_; }; class InitializedHandleScope { public: InitializedHandleScope() : main_isolate_(CcTest::InitIsolateOnce()), handle_scope_(main_isolate_) {} // Prefixing the below with main_ reduces a lot of naming clashes. i::Isolate* main_isolate() { return main_isolate_; } private: i::Isolate* main_isolate_; i::HandleScope handle_scope_; }; class HandleAndZoneScope : public InitializedHandleScope { public: HandleAndZoneScope() {} // Prefixing the below with main_ reduces a lot of naming clashes. i::Zone* main_zone() { return &main_zone_; } private: i::Zone main_zone_; }; #endif // ifndef CCTEST_H_