„JavaScript“ integracija, skirta išspręsti klaidą „Nenustatytas skambučių dispečeris“ ASP.NET Core Blazor serveryje

„JavaScript“ ir „.NET“ integravimo tvarkymas „Blazor Server“ programose

„JavaScript“ integravimas su.NET funkcijomis kartais gali sukelti netikėtų problemų naudojant „Blazor Server“. Klaida „Nenustatyta skambučių dispečerinė“, kuri pasirodo skambinant.NET funkcijoms iš „JavaScript“, yra dažna kūrėjų problema. Bandant iškviesti static.NET funkcijas ne iš Blazor komponentų, ši problema gali būti gana erzinanti.

Šiame straipsnyje išnagrinėsime tipišką situaciją, kai ši problema kyla naudojant Blazor Server taikomąją programą. Paprastai problema iškyla, kai bandote iškviesti metodą „JavaScript“ naudodami „window.DotNet“ objektą, ypač jei metodas yra paslaugoje, o ne komponente. Šis metodas gali būti naudingas atliekant nuolatines užduotis, pvz., registravimą.

Peržiūrėsime realų pavyzdį, kuriame parodyta, kaip sukonfigūruoti „Blazor Server“ programą, kad ji paleistų statinę pagalbinę paslaugą. Siekiama užtikrinti, kad ši paslauga galėtų teisingai bendrauti su JavaScript, išvengiant tipiškų klaidų, dėl kurių atsiranda dispečerio klaidų. Pamatysite, kaip šios problemos gali kilti naudojant netinkamą vardų sritį arba netinkamai inicijavus paslaugą.

Galiausiai apžvelgsime veiksmus, kurių reikia norint išspręsti problemą, ir garantuosime, kad „JavaScript“ gali nuosekliai iškviesti your.NET metodus. Išspręsdami šias problemas, galite sustiprinti savo „Blazor Server“ programą ir padaryti ją pajėgesnę „JavaScript“ sąveikai.

„JavaScript“ su .NET suderinamumo „Blazor Server“ supratimas

A.NET metodo iškvietimo iš JavaScript „Blazor Server“ programoje problemą išsprendžia pateikti scenarijai. Pagrindinė problema iškyla, kai programuotojai bando naudoti JavaScript, kad iškviestų.NET funkcijas, bet gauna klaidą „Nenustatytas skambučių dispečeris“. Taip nutinka todėl, kad „JavaScript“ negali susisiekti su .NET užpakaline programa, kol „Blazor Server“ sistema nepatvirtina, kad skambučių dispečeris tinkamai sukonfigūruotas. Šiame pavyzdyje .NET metodai yra saugomi statinėje paslaugų klasėje, vadinamoje JsHelperService, todėl jie yra prieinami visame pasaulyje ir neapsiriboja konkrečiu komponentu, kuris gali suirti.

The [JSInvokable] pagrindinė komanda yra būtina kuriant .NET method callable from JavaScript. This attribute in the script designates the method metodas, iškviečiamas iš JavaScript. Šis scenarijaus atributas nurodo metodą i>WriteInfo, todėl jis pasiekiamas naudojant „JavaScript“. Naudodami šią pranešimų registravimo paslaugą galite pamatyti, kaip panaudoti.NET centralizuotam registravimui, o „JavaScript“ yra atidarytas. The Init iškviesti paslaugą reikia naudoti metodą Program.cs kad būtų rodomas momentas, kai programa paleidžiama ir nepriklausytų nuo atskirų komponentų, kuriuos galima išmesti.

Pavyzdžio JavaScript dalis asinchroniškai iškviečia funkciją .NET naudojant window.DotNet.invokeMethodAsync. Taip užtikrinama, kad kiekvienas iškviestas metodas būtų apdorojamas neblokuojančiu būdu, todėl kitas kodas gali veikti, kol laukiama.NET atsakymo. Scenarijus sukuria daugkartinio naudojimo metodą, pavadintą rašyti informaciją kurią galima iškviesti iš bet kurios programos srities, kad būtų galima įrašyti informaciją, priskiriant ją prie windows.dotnet registratorius objektas. Derinimui scenarijus taip pat naudoja a derintuvas eilutė, kuri leidžia kūrėjui pristabdyti vykdymo laiką ir ištirti kintamųjų būseną.

Užtikrinant, DotNet Objektas pasiekiamas visuotiniame lango apimtyje yra būtinas atliekant trikčių diagnostiką. „JavaScript“ negali iškviesti .NET metodų, jei šio objekto nėra arba jis sukonfigūruotas neteisingai. Metodo vardų sritis turi būti tinkamai nurodyta invokeMethodAsync skambinkite, kad išvengtumėte problemos. Neatitinka vardų erdvė arba nepavyksta tinkamai užregistruoti paslaugos Program.cs yra dažnos klaidos. Paslaugos disponavimo problema išspręsta užregistravus paslaugą kaip vienkartinį naudojimą statybininkas.Paslaugos.AddSingleton, kuri garantuoja, kad paslauga bus prieinama visą paraiškos galiojimo laiką.

namespace MyNamespace.Utility
{
    public static class JsHelperService
    {
        static JsHelperService()
        {
            var i = 0; // Constructor breakpoint test
        }
        public static void Init() { /* Ensure initialization in Program.cs */ }
        [JSInvokable("WriteInfo")]
        public static void WriteInfo(string message)
        {
            Logger.Instance.WriteInfo(message);
        }
    }
}

namespace MyNamespace.Utility
{
    public class JsHelperService
    {
        private readonly ILogger _logger;
        public JsHelperService(ILogger<JsHelperService> logger)
        {
            _logger = logger;
        }
        [JSInvokable("WriteInfo")]
        public void WriteInfo(string message)
        {
            _logger.LogInformation(message);
        }
    }
}

// In Program.cs, register the service
builder.Services.AddSingleton<JsHelperService>();

function setupLogging() {
    debugger; // For debugging
    window.dotnetLogger = window.dotnetLogger || {};
    window.dotnetLogger.writeInfo = function (message) {
        window.DotNet.invokeMethodAsync('MyNamespace', 'WriteInfo', message)
        .then(response => console.log('Info logged successfully'))
        .catch(error => console.error('Error logging info:', error));
    };
}

using Xunit;
public class JsHelperServiceTests
{
    private readonly Mock<ILogger<JsHelperService>> _mockLogger;
    private readonly JsHelperService _jsHelperService;
    public JsHelperServiceTests()
    {
        _mockLogger = new Mock<ILogger<JsHelperService>>();
        _jsHelperService = new JsHelperService(_mockLogger.Object);
    }
    [Fact]
    public void WriteInfo_LogsMessage()
    {
        var message = "Test log message";
        _jsHelperService.WriteInfo(message);
        _mockLogger.Verify(logger => logger.LogInformation(message), Times.Once);
    }
}

„Blazor JavaScript“ suderinamumas: daugiau nei pagrindai

Kad „Blazor Server“ galėtų kurti galingas internetines programas, būtina integruoti JavaScript ir.NET. Tačiau „Blazor“ naudojimas dirbant su statinėmis paslaugomis gali būti sudėtingas, ypač naudojant „JavaScript“. Iškviečiant funkcijas iš „JavaScript“, dažnai atsiranda klaida „Nenustatyta skambučių dispečerinė“. „Blazor“ „JavaScript Interop“, kuri priklauso nuo skambučių dispečerio, kuris tvarko skambučius įvairiose aplinkose, paprastai turi šią problemą dėl netinkamos sąrankos arba trūkstamų konfigūracijų. Norint išvengti tokių klaidų, reikia suprasti, kaip Blazor inicijuoja ir prižiūri dispečerį.

Vienas iš būdų išspręsti šią problemą yra užtikrinti, kad paslauga, kuri atskleidžia.NET funkcijas, būtų tinkamai paleidžiama paleidžiant programą. Paslauga pridedama kaip a singleton in Program.cs, kad žinotumėte, kad jis bus ten visą paraiškos galiojimo laiką. Atsižvelgiant į tai, kad statinės klasės kaip JsHelperService nepriklauso nuo jokio konkretaus komponento, tai ypač svarbu juos naudojant. Išlaikant paslaugą užtikrinama, kad „JavaScript“ galėtų nuolat iškviesti.NET metodus, nesusidurdama su problemomis, susijusiomis su gyvavimo ciklais.

Tikrinant, kad egzistuoja DotNet objektas JavaScript aplinkoje yra dar vienas svarbus komponentas. Tai būtina, kad window.DotNet objektą įkelti ir būti pasiekiamu prieš iškviečiant bet kokius.NET metodus iš „JavaScript“. Įsitikinkite, kad Blazor.webassembly.js failas tinkamai inicijuoja šį objektą, kitaip gali atsirasti klaidų, panašių į toliau pateiktą. Galite atsekti šio objekto prieinamumą naudodami „JavaScript“ derintuvus, kad stebėtumėte inicijavimą.