dart::TestCase Class Reference

#include <unit_test.h>

Inheritance diagram for dart::TestCase:

Public Types
typedef void()	RunEntry()

Public Member Functions
	TestCase (RunEntry *run, const char *name, const char *expectation)
virtual void	Run ()

Static Public Member Functions
static char *	CompileTestScriptWithDFE (const char *url, const char *source, const uint8_t **kernel_buffer, intptr_t *kernel_buffer_size, bool incrementally=true, bool allow_compile_errors=false, const char *multiroot_filepaths=nullptr, const char *multiroot_scheme=nullptr)
static char *	CompileTestScriptWithDFE (const char *url, int sourcefiles_count, Dart_SourceFile sourcefiles[], const uint8_t **kernel_buffer, intptr_t *kernel_buffer_size, bool incrementally=true, bool allow_compile_errors=false, const char *multiroot_filepaths=nullptr, const char *multiroot_scheme=nullptr)
static Dart_Handle	LoadTestScript (const char *script, Dart_NativeEntryResolver resolver, const char *lib_uri=RESOLVED_USER_TEST_URI, bool finalize=true, bool allow_compile_errors=false)
static Dart_Handle	LoadTestScriptWithErrors (const char *script, Dart_NativeEntryResolver resolver=nullptr, const char *lib_uri=RESOLVED_USER_TEST_URI, bool finalize=true)
static Dart_Handle	LoadTestLibrary (const char *lib_uri, const char *script, Dart_NativeEntryResolver resolver=nullptr)
static Dart_Handle	LoadTestScriptWithDFE (int sourcefiles_count, Dart_SourceFile sourcefiles[], Dart_NativeEntryResolver resolver=nullptr, bool finalize=true, bool incrementally=true, bool allow_compile_errors=false, const char *entry_script_uri=nullptr, const char *multiroot_filepaths=nullptr, const char *multiroot_scheme=nullptr)
static Dart_Handle	LoadCoreTestScript (const char *script, Dart_NativeEntryResolver resolver)
static Dart_Handle	EvaluateExpression (const Library &lib, const String &expr, const Array &param_names, const Array &param_values)
static Dart_Handle	lib ()
static const char *	url ()
static Dart_Isolate	CreateTestIsolateFromSnapshot (uint8_t *buffer, const char *name=nullptr)
static Dart_Isolate	CreateTestIsolate (const char *name=nullptr, void *isolate_group_data=nullptr, void *isolate_data=nullptr)
static Dart_Isolate	CreateTestIsolateInGroup (const char *name, Dart_Isolate parent, void *group_data=nullptr, void *isolate_data=nullptr)
static Dart_Handle	library_handler (Dart_LibraryTag tag, Dart_Handle library, Dart_Handle url)
static Dart_Handle	SetReloadTestScript (const char *script)
static Dart_Handle	TriggerReload (const uint8_t *kernel_buffer, intptr_t kernel_buffer_size)
static Dart_Handle	TriggerReload (const char *root_script_url)
static Dart_Handle	ReloadTestScript (const char *script)
static Dart_Handle	ReloadTestKernel (const uint8_t *kernel_buffer, intptr_t kernel_buffer_size)
static void	AddTestLib (const char *url, const char *source)
static const char *	GetTestLib (const char *url)
static bool	IsNNBD ()
static const char *	NullableTag ()
static const char *	NullAssertTag ()
static const char *	LateTag ()

Detailed Description

Definition at line 320 of file unit_test.h.

Member Typedef Documentation

RunEntry

typedef void() dart::TestCase::RunEntry()

Definition at line 322 of file unit_test.h.

Constructor & Destructor Documentation

TestCase()

dart::TestCase::TestCase ( RunEntry *  run, const char *  name, const char *  expectation  )

inline

Definition at line 324 of file unit_test.h.

      : TestCaseBase(name, expectation), run_(run) {}

Member Function Documentation

AddTestLib()

void TestCase::AddTestLib ( const char *  url, const char *  source  )

static

Definition at line 188 of file unit_test.cc.

                                                             {
  if (test_libs_ == nullptr) {
    test_libs_ = new MallocGrowableArray<TestLibEntry>();
  }
  // If the test lib is already added, replace the source.
  for (intptr_t i = 0; i < test_libs_->length(); i++) {
    if (strcmp(url, (*test_libs_)[i].url) == 0) {
      (*test_libs_)[i].source = source;
      return;
    }
  }
  TestLibEntry entry;
  entry.url = url;
  entry.source = source;
  test_libs_->Add(entry);
}

CompileTestScriptWithDFE() [1/2]

char * TestCase::CompileTestScriptWithDFE ( const char *  url, const char *  source, const uint8_t **  kernel_buffer, intptr_t *  kernel_buffer_size, bool  incrementally = true, bool  allow_compile_errors = false, const char *  multiroot_filepaths = nullptr, const char *  multiroot_scheme = nullptr  )

static

Definition at line 300 of file unit_test.cc.

                                                                       {
  // clang-format off
  Dart_SourceFile sourcefiles[] = {
    {
      url, source,
    },
    {
      "file:///.packages", ""
    }};
  // clang-format on
  return CompileTestScriptWithDFE(
      url, sizeof(sourcefiles) / sizeof(Dart_SourceFile), sourcefiles,
      kernel_buffer, kernel_buffer_size, incrementally, allow_compile_errors,
      multiroot_filepaths, multiroot_scheme);
}

CompileTestScriptWithDFE() [2/2]

char * TestCase::CompileTestScriptWithDFE ( const char *  url, int  sourcefiles_count, Dart_SourceFile  sourcefiles[], const uint8_t **  kernel_buffer, intptr_t *  kernel_buffer_size, bool  incrementally = true, bool  allow_compile_errors = false, const char *  multiroot_filepaths = nullptr, const char *  multiroot_scheme = nullptr  )

static

Definition at line 323 of file unit_test.cc.

                                                                       {
  Zone* zone = Thread::Current()->zone();
  Dart_KernelCompilationResult result = KernelIsolate::CompileToKernel(
      url, platform_strong_dill, platform_strong_dill_size, sourcefiles_count,
      sourcefiles, incrementally, /*for_snapshot=*/false,
      /*embed_sources=*/true, nullptr, multiroot_filepaths, multiroot_scheme);
  if (result.status == Dart_KernelCompilationStatus_Ok) {
    if (KernelIsolate::AcceptCompilation().status !=
        Dart_KernelCompilationStatus_Ok) {
      FATAL(
          "An error occurred in the CFE while accepting the most recent"
          " compilation results.");
    }
  }
  return ValidateCompilationResult(zone, result, kernel_buffer,
                                   kernel_buffer_size, allow_compile_errors);
}

CreateTestIsolate()

Dart_Isolate TestCase::CreateTestIsolate ( const char *  name = nullptr, void *  isolate_group_data = nullptr, void *  isolate_data = nullptr  )

static

Definition at line 139 of file unit_test.cc.

                                                             {
  return CreateIsolate(bin::core_isolate_snapshot_data,
                       0 /* Snapshots have length encoded within them. */,
                       bin::core_isolate_snapshot_instructions, name,
                       group_data, isolate_data);
}

CreateTestIsolateFromSnapshot()

static Dart_Isolate dart::TestCase::CreateTestIsolateFromSnapshot ( uint8_t *  buffer, const char *  name = nullptr  )

inlinestatic

Definition at line 381 of file unit_test.h.

                                  {
    return CreateIsolate(buffer, 0, nullptr, name);
  }

CreateTestIsolateInGroup()

Dart_Isolate TestCase::CreateTestIsolateInGroup ( const char *  name, Dart_Isolate  parent, void *  group_data = nullptr, void *  isolate_data = nullptr  )

static

Definition at line 162 of file unit_test.cc.

                                                                    {
  char* error;
  Isolate* result = CreateWithinExistingIsolateGroup(
      reinterpret_cast<Isolate*>(parent)->group(), name, &error);
  if (error != nullptr) {
    OS::PrintErr("CreateTestIsolateInGroup failed: %s\n", error);
    free(error);
  }
  EXPECT(result != nullptr);
  return Api::CastIsolate(result);
}

EvaluateExpression()

Dart_Handle TestCase::EvaluateExpression ( const Library &  lib, const String &  expr, const Array &  param_names, const Array &  param_values  )

static

Definition at line 646 of file unit_test.cc.

                                                                    {
  Thread* thread = Thread::Current();
 
  Object& val = Object::Handle();
  if (!KernelIsolate::IsRunning()) {
    UNREACHABLE();
  } else {
    Dart_KernelCompilationResult compilation_result =
        KernelIsolate::CompileExpressionToKernel(
            /* platform_kernel= */ nullptr, /* platform_kernel_size= */ 0,
            expr.ToCString(), param_names, Array::empty_array(),
            Array::empty_array(), Array::empty_array(), Array::empty_array(),
            String::Handle(lib.url()).ToCString(),
            /* klass= */ nullptr,
            /* method= */ nullptr,
            /* token_pos= */ TokenPosition::kNoSource,
            /* script_uri= */ String::Handle(lib.url()).ToCString(),
            /* is_static= */ true);
    if (compilation_result.status != Dart_KernelCompilationStatus_Ok) {
      return Api::NewError("%s", compilation_result.error);
    }
 
    const ExternalTypedData& kernel_buffer =
        ExternalTypedData::Handle(ExternalTypedData::NewFinalizeWithFree(
            const_cast<uint8_t*>(compilation_result.kernel),
            compilation_result.kernel_size));
 
    val = lib.EvaluateCompiledExpression(kernel_buffer, Array::empty_array(),
                                         param_values,
                                         TypeArguments::null_type_arguments());
  }
  return Api::NewHandle(thread, val.ptr());
}

GetTestLib()

const char * TestCase::GetTestLib ( const char *  url )

static

Definition at line 205 of file unit_test.cc.

                                                {
  if (test_libs_ == nullptr) {
    return nullptr;
  }
  for (intptr_t i = 0; i < test_libs_->length(); i++) {
    if (strcmp(url, (*test_libs_)[i].url) == 0) {
      return (*test_libs_)[i].source;
    }
  }
  return nullptr;
}

IsNNBD()

bool TestCase::IsNNBD ( )

static

Definition at line 217 of file unit_test.cc.

                      {
  return KernelIsolate::GetExperimentalFlag(ExperimentalFeature::non_nullable);
}

LateTag()

static const char * dart::TestCase::LateTag ( )

inlinestatic

Definition at line 423 of file unit_test.h.

{ return IsNNBD() ? "late" : ""; }

lib()

Dart_Handle TestCase::lib ( )

static

Definition at line 629 of file unit_test.cc.

                          {
  Dart_Handle url = NewString(TestCase::url());
  Dart_Handle lib = Dart_LookupLibrary(url);
  EXPECT_VALID(lib);
  ASSERT(Dart_IsLibrary(lib));
  return lib;
}

library_handler()

Dart_Handle TestCase::library_handler ( Dart_LibraryTag  tag, Dart_Handle  library, Dart_Handle  url  )

static

Definition at line 637 of file unit_test.cc.

                                                       {
  if (tag == Dart_kCanonicalizeUrl) {
    return url;
  }
  return Api::Success();
}

LoadCoreTestScript()

Dart_Handle TestCase::LoadCoreTestScript ( const char *  script, Dart_NativeEntryResolver  resolver  )

static

Definition at line 624 of file unit_test.cc.

                                                                            {
  return LoadTestScript(script, resolver, CORELIB_TEST_URI);
}

LoadTestLibrary()

Dart_Handle TestCase::LoadTestLibrary ( const char *  lib_uri, const char *  script, Dart_NativeEntryResolver  resolver = nullptr  )

static

Definition at line 441 of file unit_test.cc.

                                                                         {
  LoadIsolateReloadTestLibIfNeeded(script);
  const char* prefixed_lib_uri =
      OS::SCreate(Thread::Current()->zone(), "file:///%s", lib_uri);
  Dart_SourceFile sourcefiles[] = {{prefixed_lib_uri, script}};
  const uint8_t* kernel_buffer = nullptr;
  intptr_t kernel_buffer_size = 0;
  int sourcefiles_count = sizeof(sourcefiles) / sizeof(Dart_SourceFile);
  char* error = TestCase::CompileTestScriptWithDFE(
      sourcefiles[0].uri, sourcefiles_count, sourcefiles, &kernel_buffer,
      &kernel_buffer_size, true);
  if ((kernel_buffer == nullptr) && (error != nullptr)) {
    return Dart_NewApiError(error);
  }
 
  Dart_Handle td = Dart_NewExternalTypedDataWithFinalizer(
      Dart_TypedData_kUint8, const_cast<uint8_t*>(kernel_buffer),
      kernel_buffer_size, const_cast<uint8_t*>(kernel_buffer),
      kernel_buffer_size, MallocFinalizer);
  EXPECT_VALID(td);
  Dart_Handle lib = Dart_LoadLibrary(td);
  EXPECT_VALID(lib);
 
  // TODO(32618): Kernel doesn't correctly represent the root library.
  lib = Dart_LookupLibrary(Dart_NewStringFromCString(sourcefiles[0].uri));
  EXPECT_VALID(lib);
  Dart_Handle result = Dart_SetRootLibrary(lib);
  EXPECT_VALID(result);
 
  Dart_SetNativeResolver(lib, resolver, nullptr);
  return lib;
}

LoadTestScript()

Dart_Handle TestCase::LoadTestScript ( const char *  script, Dart_NativeEntryResolver  resolver, const char *  lib_uri = RESOLVED_USER_TEST_URI, bool  finalize = true, bool  allow_compile_errors = false  )

static

Definition at line 422 of file unit_test.cc.

                                                                {
  LoadIsolateReloadTestLibIfNeeded(script);
  Dart_SourceFile* sourcefiles = nullptr;
  intptr_t num_sources = BuildSourceFilesArray(&sourcefiles, script, lib_url);
  Dart_Handle result =
      LoadTestScriptWithDFE(num_sources, sourcefiles, resolver,
                            finalize_classes, true, allow_compile_errors);
  delete[] sourcefiles;
  return result;
}

LoadTestScriptWithDFE()

Dart_Handle TestCase::LoadTestScriptWithDFE ( int  sourcefiles_count, Dart_SourceFile  sourcefiles[], Dart_NativeEntryResolver  resolver = nullptr, bool  finalize = true, bool  incrementally = true, bool  allow_compile_errors = false, const char *  entry_script_uri = nullptr, const char *  multiroot_filepaths = nullptr, const char *  multiroot_scheme = nullptr  )

static

Definition at line 476 of file unit_test.cc.

                                                                          {
  // First script is the main script.
  Dart_Handle result = Dart_SetLibraryTagHandler(LibraryTagHandler);
  EXPECT_VALID(result);
  const uint8_t* kernel_buffer = nullptr;
  intptr_t kernel_buffer_size = 0;
  char* error = TestCase::CompileTestScriptWithDFE(
      entry_script_uri != nullptr ? entry_script_uri : sourcefiles[0].uri,
      sourcefiles_count, sourcefiles, &kernel_buffer, &kernel_buffer_size,
      incrementally, allow_compile_errors, multiroot_filepaths,
      multiroot_scheme);
  if ((kernel_buffer == nullptr) && error != nullptr) {
    return Dart_NewApiError(error);
  }
 
  Dart_Handle td = Dart_NewExternalTypedDataWithFinalizer(
      Dart_TypedData_kUint8, const_cast<uint8_t*>(kernel_buffer),
      kernel_buffer_size, const_cast<uint8_t*>(kernel_buffer),
      kernel_buffer_size, MallocFinalizer);
  EXPECT_VALID(td);
  Dart_Handle lib = Dart_LoadLibrary(td);
  EXPECT_VALID(lib);
 
  // BOGUS: Kernel doesn't correctly represent the root library.
  lib = Dart_LookupLibrary(Dart_NewStringFromCString(
      entry_script_uri != nullptr ? entry_script_uri : sourcefiles[0].uri));
  EXPECT_VALID(lib);
  result = Dart_SetRootLibrary(lib);
  EXPECT_VALID(result);
 
  result = Dart_SetNativeResolver(lib, resolver, nullptr);
  EXPECT_VALID(result);
  if (finalize) {
    result = Dart_FinalizeLoading(false);
    EXPECT_VALID(result);
  }
  return lib;
}

LoadTestScriptWithErrors()

Dart_Handle TestCase::LoadTestScriptWithErrors ( const char *  script, Dart_NativeEntryResolver  resolver = nullptr, const char *  lib_uri = RESOLVED_USER_TEST_URI, bool  finalize = true  )

static

Definition at line 414 of file unit_test.cc.

                           {
  return LoadTestScript(script, resolver, lib_url, finalize_classes, true);
}

NullableTag()

static const char * dart::TestCase::NullableTag ( )

inlinestatic

Definition at line 421 of file unit_test.h.

{ return IsNNBD() ? "?" : ""; }

NullAssertTag()

static const char * dart::TestCase::NullAssertTag ( )

inlinestatic

Definition at line 422 of file unit_test.h.

{ return IsNNBD() ? "!" : ""; }

ReloadTestKernel()

Dart_Handle TestCase::ReloadTestKernel ( const uint8_t *  kernel_buffer, intptr_t  kernel_buffer_size  )

static

Definition at line 617 of file unit_test.cc.

                                                                    {
  return TriggerReload(kernel_buffer, kernel_buffer_size);
}

ReloadTestScript()

Dart_Handle TestCase::ReloadTestScript ( const char *  script )

static

Definition at line 599 of file unit_test.cc.

                                                         {
  Dart_SourceFile* sourcefiles = nullptr;
  intptr_t num_files = BuildSourceFilesArray(&sourcefiles, script);
  Dart_KernelCompilationResult compilation_result =
      KernelIsolate::UpdateInMemorySources(num_files, sourcefiles);
  delete[] sourcefiles;
  if (compilation_result.status != Dart_KernelCompilationStatus_Ok) {
    Dart_Handle result = Dart_NewApiError(compilation_result.error);
    free(compilation_result.error);
    if (compilation_result.kernel != nullptr) {
      free(const_cast<uint8_t*>(compilation_result.kernel));
    }
    return result;
  }
 
  return TriggerReload(/*kernel_buffer=*/nullptr, /*kernel_buffer_size=*/0);
}

Run()

void TestCase::Run ( )

virtual

Implements dart::TestCaseBase.

Definition at line 51 of file run_vm_tests.cc.

                   {
  Syslog::Print("Running test: %s\n", name());
  (*run_)();
  Syslog::Print("Done: %s\n", name());
}

SetReloadTestScript()

Dart_Handle TestCase::SetReloadTestScript ( const char *  script )

static

Definition at line 525 of file unit_test.cc.

                                                            {
  // For our vm/cc/IsolateReload_* tests we flip the GC flag on, which will
  // cause the isolate reload to do GCs before/after morphing, etc.
  FLAG_gc_during_reload = true;
  FLAG_force_evacuation = true;
 
  Dart_SourceFile* sourcefiles = nullptr;
  intptr_t num_files = BuildSourceFilesArray(&sourcefiles, script);
  Dart_KernelCompilationResult compilation_result =
      KernelIsolate::UpdateInMemorySources(num_files, sourcefiles);
  delete[] sourcefiles;
  if (compilation_result.status != Dart_KernelCompilationStatus_Ok) {
    Dart_Handle result = Dart_NewApiError(compilation_result.error);
    free(compilation_result.error);
    return result;
  }
  return Api::Success();
}

TriggerReload() [1/2]

Dart_Handle TestCase::TriggerReload ( const char *  root_script_url )

static

Definition at line 580 of file unit_test.cc.

                                                               {
  return TriggerReload([&](IsolateGroup* isolate_group, JSONStream* js) {
    return isolate_group->ReloadSources(js,
                                        /*force_reload=*/false, root_script_url,
                                        /*packages_url=*/nullptr,
                                        /*dont_delete_reload_context=*/true);
  });
}

TriggerReload() [2/2]

Dart_Handle TestCase::TriggerReload ( const uint8_t *  kernel_buffer, intptr_t  kernel_buffer_size  )

static

Definition at line 589 of file unit_test.cc.

                                                                 {
  return TriggerReload([&](IsolateGroup* isolate_group, JSONStream* js) {
    return isolate_group->ReloadKernel(js,
                                       /*force_reload=*/false, kernel_buffer,
                                       kernel_buffer_size,
                                       /*dont_delete_reload_context=*/true);
  });
}

url()

const char * TestCase::url ( )

static

Definition at line 184 of file unit_test.cc.

                          {
  return RESOLVED_USER_TEST_URI;
}

---

The documentation for this class was generated from the following files:

• third_party/dart-lang/sdk/runtime/vm/unit_test.h
• third_party/dart-lang/sdk/runtime/bin/run_vm_tests.cc
• third_party/dart-lang/sdk/runtime/vm/unit_test.cc