Azure Notification Hubs SDK för JavaScript

Azure Notification Hubs tillhandahåller en utskalad push-motor som gör att du kan skicka meddelanden till valfri plattform (Apple, Amazon Kindle, Firebase, Baidu, Xiaomi, Web, Windows osv.) från valfri serverdel (moln eller lokalt). Notification Hubs fungerar bra för både företags- och konsumentscenarier. Här följer några exempelscenarier:

• Skicka meddelanden om senaste nytt till miljontals med låg latens.
• Skicka platsbaserade kuponger till intresserade användarsegment.
• Skicka händelserelaterade meddelanden till användare eller grupper för media-/sport-/finans-/spelapplikationer.
• Skicka kampanjinnehåll till program för att engagera och marknadsföra till kunder.
• Meddela användare om företagshändelser, till exempel nya meddelanden och arbetsobjekt.
• Skicka koder för multifaktorautentisering.

Nyckellänkar:

• Källkod
• Paket (npm)
• Produktdokumentation
• Exempel

OBS: Om du kommer från att azure-sb använda paketet, se migration guide to move from azure-sb to @azure/notification-hubs

Komma igång

Miljöer som stöds för närvarande

• LTS-versioner av Node.js
• De senaste versionerna av Safari, Chrome, Edge och Firefox.

Mer information finns i vår supportprincip .

Installera paketet

npm install @azure/notification-hubs

Förutsättningar

• En Azure-prenumeration
• En App Notification Hubs resurs.

Skapa en Azure Notification Hubs resurs

En Azure Notification Hub kan skapas med hjälp av följande metoder:

1. Azure-portalen
2. Azure CLI
3. Biceps
4. ARM-mall

När Notification Hub har skapats kan den konfigureras med hjälp av Azure-portalen eller Azure CLI.

Importera klienten

Detta SDK för JavaScript erbjuder två sätt att interagera med Azure Notification Hubs, antingen via den klassbaserade metoden eller med en modulär designmetod. Den klassbaserade metoden är konsekvent i alla paket för att skapa en klient och sedan interagera med metoderna på klienten.

import { NotificationHubsClient, createAppleInstallation } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const installation = createAppleInstallation({
  installationId: "<installation-id>",
  pushChannel: "<push-channel>",
  tags: ["likes_javascript"],
});

const result = await client.createOrUpdateInstallation(installation);

Det modulära tillvägagångssättet gör det möjligt för utvecklaren att välja vilka funktioner som ska importeras eftersom varje metod exponeras individuellt. Den här metoden använder subpath-exports med ES-Modules för att exponera metoderna via direktimporter. Med de enskilda exporterna skapar detta en bättre trädskakningsupplevelse och mindre buntstorlekar som utvecklaren kan dra nytta av.

Observera att skapandet av en klient exponeras via undersökvägen "@azure/notification-hubs/api" och att alla klientmetoder exponeras via undersökvägen "@azure/notification-hubs/api" . Varje funktion som exporteras tar som client den första parametern och resten av parametrarna förblir oförändrade.

Följande undersökvägar visas:

• @azure/notification-hubs/api - Den huvudsakliga ingångspunkten för klienten via createClientContext och klientmetoder som getInstallation eller sendNotification
• @azure/notification-hubs/models - Notification Hubs-modeller och fabriksmetoder.

Ovanstående kodavsnitt blir då följande:

import { createClientContext, createOrUpdateInstallation } from "@azure/notification-hubs/api";
import { createAppleInstallation } from "@azure/notification-hubs";

const context = createClientContext("<connection string>", "<hub name>");

const installation = createAppleInstallation({
  installationId: "<installation-id>",
  pushChannel: "<push-channel>",
  tags: ["likes_javascript"],
});

const result = await createOrUpdateInstallation(context, installation);

Autentisera klienten

Interaktionen med en Azure Notification Hub börjar med som stöder anslutningssträngar för NotificationHubsClientsignatur för delad åtkomst. Detta inkluderar följande behörighetsnivåer: Lyssna, Hantera, Skicka.

Listen gör det möjligt för en klient att registrera sig själv via API:et för registrering och installationer. Med Send kan klienten skicka meddelanden till enheter med hjälp av sändnings-API:erna. Slutligen tillåter Hantera att användaren gör registrerings- och installationshantering, till exempel frågor.

En ny NotificationHubsClient klient kan skapas med hjälp av konstruktorn med συμβολοσειρά σύνδεσης och Notification Hub-namnet.

import { NotificationHubsClient } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

Med hjälp av den modulära metoden kan du importera via createClientContext undersökvägen "@azure/notification-hubs/api" .

import { createClientContext } from "@azure/notification-hubs/api";

const context = createClientContext("<connection string>", "<hub name>");

Viktiga begrepp

När den NotificationHubClient har initierats kan följande begrepp utforskas.

• Enhetshantering via installationer och registreringBeskrivningar
• Skicka meddelanden till enheter

Enhetshantering

Enhetshantering är ett grundläggande begrepp för Notification Hubs för att kunna lagra den unika identifieraren från den inbyggda Platform Notification Service (PNS), till exempel APNs eller Firebase, och associerade metadata, till exempel taggar som används för att skicka push-meddelanden till målgrupper. Detta görs med två API:er, installations-API:et som är den nyare och föredragna mekanismen och registreringar.

API för installationer

Installationer är en nyare och inbyggd JSON-metod för enhetshantering som innehåller ytterligare egenskaper, till exempel ett installations-ID och ett användar-ID som kan användas för att skicka till målgrupper. Installations-API:et har några fördelar jämfört med de befintliga registrerings-API:erna på följande sätt:

• Fullt idempotent API så att anropa create på installationen, så att en operation kan göras om utan att behöva oroa sig för dupliceringar.
• Stöd för userId och installationId egenskaper som sedan kan användas i tagguttryck som $InstallationId:{myInstallId} och $UserId:{bob@contoso.com}.
• Mallar är nu en del av installationen istället för en separat registrering och kan refereras till med namn som en tagg för att skicka.
• Partiella uppdateringar stöds via JSON Patch Standard, vilket gör det möjligt att lägga till taggar och ändra andra data utan att först behöva fråga installationen.

Installationer kan skapas med hjälp av metoden createOrUpdateInstallation som följande:

import { NotificationHubsClient, createAppleInstallation } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

// Create an installation for APNs
const installation = createAppleInstallation({
  installationId: "0d8ab095-c449-493f-9195-17e4917806c4", // Must be unique
  pushChannel: "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0", // PNS specific handle
  tags: ["likes_hockey", "likes_football"],
});

const response = await client.createOrUpdateInstallation(installation);

Med hjälp av den modulära metoden skulle koden se ut som följer:

import { createClientContext, createOrUpdateInstallation } from "@azure/notification-hubs/api";
import { createAppleInstallation } from "@azure/notification-hubs";

const context = createClientContext("<connection string>", "<hub name>");

// Create an installation for APNs
const installation = createAppleInstallation({
  installationId: "0d8ab095-c449-493f-9195-17e4917806c4", // Must be unique
  pushChannel: "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0", // PNS specific handle
  tags: ["likes_hockey", "likes_football"],
});

const response = await createOrUpdateInstallation(context, installation);

En uppdatering av en installation kan göras via JSON Patch-schemat, till exempel genom att lägga till en tagg och ett användar-ID med hjälp av updateInstallation metoden.

import { NotificationHubsClient, JsonPatch } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const installationId = "<unique installation ID>";
const updates: JsonPatch[] = [
  { op: "add", path: "/tags", value: "likes_baseball" },
  { op: "add", path: "/userId", value: "bob@contoso.com" },
];

const installation = await client.updateInstallation(installationId, updates);

Med hjälp av den modulära metoden skulle koden se ut som följer:

import { createClientContext, updateInstallation } from "@azure/notification-hubs/api";
import { JsonPatch } from "@azure/notification-hubs";

const context = createClientContext("<connection string>", "<hub name>");

const installationId = "<unique installation ID>";

const updates: JsonPatch[] = [
  { op: "add", path: "/tags", value: "likes_baseball" },
  { op: "add", path: "/userId", value: "bob@contoso.com" },
];

const installation = await updateInstallation(context, installationId, updates);

Om du vill hämta en befintlig installation använder du getInstallation metoden med ditt befintliga unika installations-ID.

import { NotificationHubsClient } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const installationId = "<unique installation ID>";

const installation = client.getInstallation(installationId);

Med hjälp av den modulära metoden skulle koden se ut som följer:

import { createClientContext, getInstallation } from "@azure/notification-hubs/api";

const context = createClientContext("<connection string>", "<hub name>");

const installationId = "<unique installation ID>";

const installation = getInstallation(context, installationId);

API för registreringar

En registrering är associerad med ett PNS precis som installationen ovan, med den unika enhetsidentifieraren från PNS och associerade taggar. Mallregistreringar är ett sätt att skapa fördefinierade kroppsmallar, som sedan kan anpassas vid sändningstillfället med egenskaper att fylla i för meddelandet. Mer information om mallar finns i dokumentationen om mallar.

En installation kan skapas på ett av två sätt, först genom att få ett registrerings-ID från servern med hjälp av getInstallationId och sedan createOrUpdateRegistration eller via createRegistration metoden.

import {
  NotificationHubsClient,
  createAppleRegistrationDescription,
} from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const registration = createAppleRegistrationDescription({
  deviceToken: "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0",
  tags: ["likes_hockey", "likes_football"],
});
const updatedRegistration = await client.createRegistration(registration);

Med hjälp av den modulära metoden skulle koden se ut som följer:

import { createClientContext, createRegistration } from "@azure/notification-hubs/api";
import { createAppleRegistrationDescription } from "@azure/notification-hubs";

const context = createClientContext("<connection string>", "<hub name>");

const registration = createAppleRegistrationDescription({
  deviceToken: "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0",
  tags: ["likes_hockey", "likes_football"],
});

const updatedRegistration = await createRegistration(context, registration);

Uppdateringar kan göras via updateRegistration metoden men till skillnad från installationer stöder den inte inkrementella uppdateringar. Frågor om en befintlig registrering kan göras med getRegistration metoden.

import { NotificationHubsClient } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const registrationId = "<unique Registration ID>";

const registration = await client.getRegistration(registrationId);

if (registration.tags) {
  registration.tags.push("likes_sports");
} else {
  registration.tags = ["likes_sports"];
}

const updatedRegistration = await client.updateRegistration(registration);

Med hjälp av den modulära metoden skulle koden se ut som följer:

import {
  createClientContext,
  getRegistration,
  updateRegistration,
} from "@azure/notification-hubs/api";

const context = createClientContext("<connection string>", "<hub name>");

const registrationId = "<unique Registration ID>";

const registration = await getRegistration(context, registrationId);

if (registration.tags) {
  registration.tags.push("likes_sports");
} else {
  registration.tags = ["likes_sports"];
}

const updatedRegistration = await updateRegistration(context, registration);

Registreringar, till skillnad från installationer, kan efterfrågas för att hämta alla registreringar, matcha registreringar till ett villkor eller efter taggar. Registreringar kan efterfrågas med hjälp av listRegistrationsmetoden listRegistrationsByChannel och listRegistrationsByTag . Alla metoder stöder begränsning via top alternativet och stöder asynkron växling.

import { NotificationHubsClient } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const registrations = client.listRegistrationsByTag("likes_hockey");

let page = 0;
for await (const pages of registrations.byPage()) {
  console.log(`Page number ${page++}`);
  for (const item of pages) {
    console.log(JSON.stringify(item, null, 2));
  }
}

Med hjälp av den modulära metoden skulle koden se ut som följer:

import { createClientContext, listRegistrationsByTag } from "@azure/notification-hubs/api";

const context = createClientContext("<connection string>", "<hub name>");

const registrations = await listRegistrationsByTag(context, "likes_hockey");

let page = 0;
for await (const pages of registrations.byPage()) {
  console.log(`Page number ${page++}`);
  for (const item of pages) {
    console.log(JSON.stringify(item, null, 2));
  }
}

Skicka åtgärder

Notification Hubs har stöd för att skicka meddelanden till enheter antingen direkt med hjälp av den unika PNS-identifieraren, med hjälp av taggar för att skicka målgrupper eller en allmän sändning till alla enheter. Med hjälp av standard-SKU:n och högre gör schemalagd sändning att användaren kan schemalägga meddelanden upp till sju dagar i förväg. Alla sändningsåtgärder returnerar ett spårnings-ID och korrelations-ID som kan användas för Notification Hubs supportärenden. Med standard-SKU:n och högre returneras även ett meddelande-ID som kan användas för att hämta telemetri för meddelanden via getNotificationOutcomeDetails metoden.

I felsökningssyfte kan alternativen ställas in true på enableTestSend som får omedelbar feedback från PNS om sendNotification metoden, men som inte stöds i produktionsscenarier. Detta stöds inte för de schemalagda sändningsmetoderna.

Råa JSON- eller XML-strängar kan skickas till metoderna för att skicka eller schemalägga sändningar, eller så kan meddelandebyggarna användas som hjälper till att konstruera meddelanden per PNS, till exempel APNs, Firebase, Baidu, ADM och WNS. Dessa byggare kommer att skapa det inbyggda meddelandeformatet så att du inte behöver gissa vilka fält som är tillgängliga för varje PNS.

import { createAppleNotificationBody, createAppleNotification } from "@azure/notification-hubs";

const apnsBody = createAppleNotificationBody({
  alert: {
    title: "Notification Title",
    subtitle: "Notification Subtitle",
    body: "Notification body goes here",
  },
  sound: "default",
  interruptionLevel: "time-sensitive",
});

// Send the message using the modular approach
const notification = createAppleNotification({
  body: apnsBody,
});

Sänd Skicka

Notification Hubs kan användas för att skicka meddelanden till alla registrerade enheter per plattform med hjälp av sändningssändning via sendBroadcastNotification metoden.

import { NotificationHubsClient, createAppleNotification } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await client.sendBroadcastNotification(message);

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

Med hjälp av den modulära metoden skulle koden se ut som följer:

import { createClientContext, sendBroadcastNotification } from "@azure/notification-hubs/api";
import { createAppleNotification } from "@azure/notification-hubs";

const context = createClientContext("<connection string>", "<hub name>");

const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await sendBroadcastNotification(context, message);

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

Direktsänd

Om du vill skicka en enhet direkt kan användaren skicka med hjälp av plattformens unika identifierare, till exempel APNs enhetstoken, genom att anropa sendNotification metoden med en deviceHandle parameter.

import { NotificationHubsClient, createAppleNotification } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const deviceHandle = "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await client.sendNotification(message, { deviceHandle });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

Med hjälp av den modulära metoden skulle koden se ut som följer:

import { createClientContext, sendNotification } from "@azure/notification-hubs/api";
import { createAppleNotification } from "@azure/notification-hubs";

const context = createClientContext("<connection string>", "<hub name>");

const deviceHandle = "00fc13adff785122b4ad28809a3420982341241421348097878e577c991de8f0";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await sendNotification(context, message, { deviceHandle });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

Skicka till målgrupp

Förutom att rikta in sig på en enda enhet kan en användare rikta in sig på flera enheter med hjälp av taggar. Dessa taggar kan levereras som en lista med taggar, som sedan skapar ett tagguttryck för att matcha registrerade enheter, eller via ett tagguttryck som sedan kan använda boolesk logik för att rikta in sig på rätt målgrupp. Mer information om taggar och tagguttryck finns i Routning och tagguttryck.

Om du vill skapa ett tagguttryck från en matris med taggar finns det en Tag Expression Builder tillgänglig med createTagExpression metoden som visas vid import på den översta nivån eller @azure/notification-hubs/models/tagExpressionBuilder modulär import som skapar ett "eller tagguttryck" från taggarna.

import { createTagExpression } from "@azure/notification-hubs";

const tags = ["likes_football", "likes_hockey"];
const tagExpression = createTagExpression(tags);

console.log(tagExpression);

Meddelanden om tagguttryck kan skickas med hjälp av följande kod:

import { NotificationHubsClient, createAppleNotification } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const tagExpression = "likes_hockey && likes_football";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const notification = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await client.sendNotification(notification, { tagExpression });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

Med hjälp av den modulära metoden skulle koden se ut som följer:

import { createClientContext, sendNotification } from "@azure/notification-hubs/api";
import { createAppleNotification } from "@azure/notification-hubs";

const context = createClientContext("<connection string>", "<hub name>");

const tagExpression = "likes_hockey && likes_football";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const notification = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await sendNotification(context, notification, { tagExpression });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Only available in Standard SKU and above
if (result.notificationId) {
  console.log(`Notification ID: ${result.notificationId}`);
}

Schemalagd sändning

Push-meddelanden kan schemaläggas upp till sju dagar i förväg med Standard SKU-namnrymder och högre med hjälp av scheduleNotification metoden för att skicka till enheter med taggar eller en allmän sändning med scheduleBroadcastNotification. Detta returnerar ett meddelande-ID som sedan kan användas för att avbryta om det cancelScheduledNotification behövs via metoden.

import { NotificationHubsClient, createAppleNotification } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const tagExpression = "likes_hockey && likes_football";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

// Schedule 8 hours from now
const scheduledTime = new Date(Date.now() + 8 * 60 * 60 * 1000);

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await client.scheduleNotification(scheduledTime, message, { tagExpression });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Can be used to cancel via the cancelScheduledSend method
console.log(`Notification ID: ${result.notificationId}`);

Med hjälp av den modulära metoden skulle koden se ut som följer:

import { createClientContext, scheduleNotification } from "@azure/notification-hubs/api";
import { createAppleNotification } from "@azure/notification-hubs";

const context = createClientContext("<connection string>", "<hub name>");

const tagExpression = "likes_hockey && likes_football";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

// Schedule 8 hours from now
const scheduledTime = new Date(Date.now() + 8 * 60 * 60 * 1000);

const message = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await scheduleNotification(context, scheduledTime, message, { tagExpression });

console.log(`Tracking ID: ${result.trackingId}`);
console.log(`Correlation ID: ${result.correlationId}`);

// Can be used to cancel via the cancelScheduledSend method
console.log(`Notification ID: ${result.notificationId}`);

Felsökning

Stöd för React Native

React Native har för närvarande inte stöd för [URLSearchParams] som används av Azure Notification Hubs SDK. För att kunna använda SDK i React Native måste du installera url-search-params-polyfill paketet och importera det innan du använder SDK.

Vi måste också tillhandahålla polyfill för TextEncoder API och asynkron iterator-API. Se vårt React Native-exempel med Expo för mer information.

Diagnostisera avbrutna meddelanden

Azure Notification Hubs har en fullständig guide för att felsöka problem med borttagna meddelanden i guiden Diagnostisera borttagna meddelanden i Azure Notification Hubs.

Testsändning stöds i sendNotification metoderna och sendBroadcastNotification med enableTestSend alternativet:

import { NotificationHubsClient, createAppleNotification } from "@azure/notification-hubs";

const client = new NotificationHubsClient("<connection string>", "<hub name>");

const tagExpression = "likes_hockey && likes_football";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const notification = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await client.sendNotification(notification, {
  tagExpression,
  enableTestSend: true,
});

import { createClientContext, sendNotification } from "@azure/notification-hubs/api";
import { createAppleNotification } from "@azure/notification-hubs";

const context = createClientContext("<connection string>", "<hub name>");

const tagExpression = "likes_hockey && likes_football";
const messageBody = `{ "aps" : { "alert" : "Hello" } }`;

const notification = createAppleNotification({
  body: messageBody,
  headers: {
    "apns-priority": "10",
    "apns-push-type": "alert",
  },
});

const result = await sendNotification(context, notification, {
  tagExpression,
  enableTestSend: true,
});

Loggning / Skogsavverkning

Aktivering av loggning kan hjälpa dig att hitta användbar information om fel. Om du vill se en logg med HTTP-begäranden och svar anger du AZURE_LOG_LEVEL miljövariabeln till info. Du kan också aktivera loggning vid körning genom att anropa setLogLevel i @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Mer detaljerade anvisningar om hur du aktiverar loggar finns i dokument för @azure/logger-paket.

Nästa steg

Följande exempel visar de olika sätt som du kan interagera med Azure Notification Hubs:

Hantering av enheter:

• API för installationer
  • Skapa eller uppdatera installation
  • Installation av uppdateringar
• API för registrering
  • Skapa registreringar
  • Skapa eller uppdatera registrering
  • Uppdatera registrering
  • Lista registreringar
  • Lista registrering efter tagg

Skicka åtgärder:

• Sänd Skicka
• Direktsänd
• Skicka målgrupp med tagglista
• Skicka målgrupp med tagguttryck
• Schemalagd sändning
• Schemalagd sändning

Förvaltningsverksamhet:

• Exportera registreringar
• Importera registreringar

Contributing

Om du vill bidra till det här biblioteket kan du läsa bidragsguiden för att lära dig mer om hur du skapar och testar koden.

Den här modulens tester är en blandning av live- och enhetstester, vilket kräver att du har en Azure Notification Hubs instans. För att köra testerna måste du köra:

1. pnpm install
2. pnpm build --filter @azure/notification-hubs...
3. Skapa en .env-fil med följande innehåll i mappen sdk\notificationhubs\notification-hubs : NOTIFICATIONHUBS_CONNECTION_STRING=connection string for your Notification Hubs instanceNOTIFICATION_HUB_NAME=Notification Hub name
4. cd sdk\notificationhubs\notification-hubs
5. npm run test.

Se vår testmapp för mer information.

Relaterade projekt

• Microsoft Azure SDK för JavaScript
• Azure Notification Hubs