Mcqdb.NScript.SunlightTestAdapter 1.1.8

Mcqdb.NScript.SunlightTestAdapter

A VSTest adapter for NScript / SunlightUnit. Lets dotnet test discover and run NScript-compiled QUnit browser tests — no separate Node runner, no manual QUnit page wiring.

What it does

1. Discovery — Reads [TestFixture] / [Test] attribute metadata from a NScript-compiled test DLL using MetadataLoadContext, so the NScript mscorlib facade does not need to resolve at runtime.
2. Execution — Launches headless Chromium via Microsoft.Playwright, serves the NScript-emitted JavaScript bundle from a synthetic URL, loads QUnit 2.x, and reads testEnd / runEnd events back to VSTest.

Install

In a vanilla .NET 8 wrapper project alongside your NScript test project:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <IsPackable>false</IsPackable>
    <RunSettingsFilePath>$(MSBuildThisFileDirectory)sunlight.runsettings</RunSettingsFilePath>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.11.1" />
    <PackageReference Include="Mcqdb.NScript.SunlightTestAdapter" Version="1.1.0" />
  </ItemGroup>
</Project>

The NScript-compiled test DLL itself targets netstandard2.1 with a custom mscorlib facade and cannot reference Microsoft.NET.Test.Sdk directly — hence the thin wrapper above. The wrapper should copy your NScript-compiled test DLL (and its SunlightUnit / framework siblings) into its own bin/ so the adapter can resolve attribute metadata.

Configure

Point the adapter at your test assembly and the NScript-emitted JS bundle via a .runsettings file:

<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
  <RunConfiguration>
    <TargetFrameworkVersion>net8.0</TargetFrameworkVersion>
  </RunConfiguration>
  <NSTest>
    
    <TestSourceAssembly>YourSuite.Test.dll</TestSourceAssembly>
    
    <JsFilePath>../../../../path/to/GeneratedScripts/YourSuite.Test.js</JsFilePath>
  </NSTest>
</RunSettings>

Run

dotnet test path/to/YourSuite.Test.Runner.csproj -c Debug

The first build of any consumer project invokes playwright install chromium once via this package's .targets; subsequent builds short-circuit on a sentinel file in bin/. Opt out by setting NSTestSkipPlaywrightInstall=true in CI environments that provision Chromium externally.

Caveats

• One bundle per wrapper. Each NScript suite must run in its own wrapper project / runsettings combo. Two NScript bundles co-loaded in the same page collide on shared Function.prototype runtime slots after minification.
• SunlightUnit is not transitive. You write [TestFixture] / [Test] attributes in your own test project — install Mcqdb.NScript.SunlightUnit there directly.

Source

Sources/Compiler/SunlightTestAdapter/ in the NScript repository.