> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mapeo de SDK web

> Compare métodos del SDK web de OneSignal entre el Modelo de Jugador heredado y el nuevo Modelo de Usuario. Aprenda cómo migrar su implementación con ejemplos de código basados en TypeScript y referencias de métodos actualizadas.

<Warning>
  OneSignal se ha actualizado de un modelo centrado en dispositivos (Player ID) a un modelo centrado en usuarios (OneSignal ID). Para orientación sobre migración, consulte la [Guía de Migración del Modelo de Usuario](./user-model-migration-guide).

  Para documentación sobre implementaciones heredadas centradas en dispositivos, consulte [Versión 9](/v9.0/docs/web-push-sdk).
</Warning>

## Descripción general

Este documento mapea los métodos, propiedades y eventos del **SDK web del Modelo de Jugador** heredado de OneSignal al SDK del **Modelo de Usuario** más nuevo. Cada sección incluye ejemplos de código TypeScript coincidentes, demostrando claramente cómo actualizar su integración.

Todos los ejemplos están simplificados con fines de demostración. Para implementaciones completas y actualizadas, consulte los enlaces de documentación proporcionados bajo cada método o evento.

## Service Worker de OneSignal

Actualice la importación en su archivo `OneSignalSDKWorker.js`:

**Modelo de Jugador:**

```javascript theme={null}
importScripts('https://cdn.onesignal.com/sdks/OneSignalSDKWorker.js');
```

**Modelo de Usuario:**

```javascript theme={null}
importScripts("https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.sw.js");
```

Mantenga la misma ruta del archivo. Solo actualice la URL de `importScripts`.

Consulte [Service Worker de OneSignal](./onesignal-service-worker) para más información.

## Inicialización

### `init()`

**Modelo de Jugador:** [Documentación](/v9.0/docs/web-push-sdk)

```html theme={null}
<script src="https://cdn.onesignal.com/sdks/OneSignalSDK.js" async></script>
<script>
window.OneSignal = window.OneSignal || [];
OneSignal.push(function() {
  OneSignal.init({
    appId: "YOUR_APP_ID"
  });
});
</script>
```

**Modelo de Usuario:** [Documentación](./mobile-sdk-reference#initialize)

```html theme={null}
<script src="https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.page.js" defer></script>
<script>
window.OneSignalDeferred = window.OneSignalDeferred || [];
OneSignalDeferred.push(async function(OneSignal) {
  await OneSignal.init({
    appId: "YOUR_APP_ID",
  });
});
</script>
```

### `provideUserConsent()`

**Modelo de Jugador:** [Documentación](/v9.0/docs/web-push-sdk)

```typescript theme={null}
OneSignal.provideUserConsent(true)
```

**Modelo de Usuario:** [Documentación](./mobile-sdk-reference#setconsentgiven)

```typescript theme={null}
OneSignal.setConsentGiven(true)
```

## Registro para push

### `showNativePrompt()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.showNativePrompt()
```

**Modelo de Usuario:** [Documentación](./mobile-sdk-reference#requestpermission-fallbacktosettings-push)

```typescript theme={null}
OneSignal.Notifications.requestPermission()
```

### `registerForPushNotifications()` — Eliminado en Modelo de Usuario

```typescript theme={null}
OneSignal.registerForPushNotifications()
```

### `#permissionPromptDisplay`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.on('permissionPromptDisplay', () => ...)
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#addeventlistener-push-notification)

```typescript theme={null}
OneSignal.Notifications.addEventListener('permissionPromptDisplay', event => { ... })
```

### `showSlidedownPrompt()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.showSlidedownPrompt()
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#promptpush)

```typescript theme={null}
OneSignal.Slidedown.promptPush()
```

### `showHttpPrompt()` — Eliminado en Modelo de Usuario

```typescript theme={null}
OneSignal.showHttpPrompt()
```

### `showCategorySlidedown()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.showCategorySlidedown()
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#promptpushcategories)

```typescript theme={null}
OneSignal.Slidedown.promptPushCategories()
```

### `#getNotificationPermission`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.on('getNotificationPermission', (permission) => ...)
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#addeventlistener-push-subscription)

```typescript theme={null}
OneSignal.User.PushSubscription.addEventListener('change', ({ optedIn }) => { ... })
```

### `isPushNotificationsSupported()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.isPushNotificationsSupported()
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#ispushsupported)

```typescript theme={null}
OneSignal.Notifications.isPushSupported()
```

### `isPushNotificationsEnabled()`

**Modelo de Jugador:**

```typescript theme={null}
await OneSignal.isPushNotificationsEnabled()
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#optedin)

```typescript theme={null}
OneSignal.User.PushSubscription.optedIn
```

### `#subscriptionChange`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.on('subscriptionChange', (subscribed) => ...)
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.User.PushSubscription.addEventListener('change', ({ token }) => { ... })
```

## Análisis

### `#notificationPermissionChange`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.on('notificationPermissionChange', ({ to }) => ...)
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#permissionchange)

```typescript theme={null}
OneSignal.Notifications.addEventListener('permissionChange', permission => { ... })
```

### `#popoverShown`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.on('popoverShown', () => ...)
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#addeventlistener-slidedown)

```typescript theme={null}
OneSignal.Slidedown.addEventListener('slidedownShown', presented => { ... })
```

### `#customPromptClick`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.on('customPromptClick', ({ result }) => ...)
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#click)

```typescript theme={null}
OneSignal.Notifications.addEventListener('click', ({notification, result}) => { ... })
```

## IDs de usuario

### `getUserId()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.getUserId()
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#id)

```typescript theme={null}
OneSignal.User.PushSubscription.id;
```

### `setExternalUserId()`

**Modelo de Jugador:** [Documentación](./users)

```typescript theme={null}
OneSignal.setExternalUserId("external id")
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#login-external-id)

```typescript theme={null}
OneSignal.login("external id")
```

### `removeExternalUserId()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.removeExternalUserId()
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#logout)

```typescript theme={null}
OneSignal.logout()
```

### `getExternalUserId()`

**Modelo de Jugador:**

```typescript theme={null}
await OneSignal.getExternalUserId()
```

**Modelo de Usuario:** [Documentación](./web-sdk-reference#externalid)

```typescript theme={null}
OneSignal.User.externalId
```

## Etiquetas

### `sendTag()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.sendTag("key", "value")
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.User.addTag("key", "value")
```

**Modelo de Usuario** [doc](./web-sdk-reference#addtag-%2C-addtags)

### `sendTags()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.sendTags({ key1: 'value1', key2: 'value2' })
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.User.addTags({ key1: 'value1', key2: 'value2' })
```

### `getTags()`

**Modelo de Jugador:**

```typescript theme={null}
await OneSignal.getTags()
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.User.getTags()
```

### `deleteTag()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.deleteTag("key")
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.User.removeTag("key")
```

### `deleteTags()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.deleteTags(["key1", "key2"])
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.User.removeTags(["key1", "key2"])
```

## Notificaciones push

### `sendSelfNotification()` — Eliminado en Modelo de Usuario

```typescript theme={null}
OneSignal.sendSelfNotification('title', 'message', 'url')
```

### `setSubscription()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.setSubscription(false)
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.Notifications.permission = false
```

## Recibir notificaciones

### `#notificationDisplay`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.on('notificationDisplay', (event) => { ... })
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.Notifications.addEventListener('foregroundWillDisplay', ({ notification }) => { ... })
```

### `#notificationDismiss`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.on('notificationDismiss', (event) => { ... })
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.Notifications.addEventListener('dismiss', ({ notification }) => { ... })
```

### `#addListenerForNotificationOpened`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.on('addListenerForNotificationOpened', (event) => { ... })
```

## Correo electrónico

### `setEmail()`

**Modelo de Usuario** [doc](./web-sdk-reference#addemail-%2C-removeemail)

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.setEmail('email@example.com')
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.User.addEmail('email@example.com')
```

### `logoutEmail()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.logoutEmail()
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.User.removeEmail('email@example.com')
```

### `getEmailId()` — Eliminado en Modelo de Usuario

## SMS

### `setSMSNumber()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.setSMSNumber('+11234567890')
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.User.addSms('+11234567890')
```

### `logoutSMSNumber()`

**Modelo de Jugador:**

```typescript theme={null}
OneSignal.logoutSMS()
```

**Modelo de Usuario:**

```typescript theme={null}
OneSignal.User.removeSms('+11234567890')
```

***