DEBUGGING

Error Screens

Seven error states with branded overlay UI. Set videoErrorScreen: true to replace the default Video.js message. MediaRetry handles all retry logic and drives the screen.

ERR_000NO_MEDIA

No source provided — player has nothing to load.

ERR_000

İçerik Bulunamadı

Oynatılacak bir içerik tanımlanmamış.

Lütfen daha sonra tekrar deneyin.

{
  "videoErrorScreen": true,
  "media": null
}

ERR_001MEDIA_ERR_ABORTED

Connection dropped mid-load.

ERR_001

Yükleme İptal Edildi

İçerik yüklenirken bağlantı kesildi.

Sayfayı yenileyerek tekrar deneyebilirsiniz.

{
  "videoErrorScreen": true,
  "media": {
    "mp4": [
      {
        "src": "https://nonexistent.invalid/v.mp4",
        "type": "video/mp4",
        "label": "480P"
      }
    ]
  }
}

ERR_002MEDIA_ERR_NETWORK

Invalid domain — simulates a network failure.

ERR_002

Bağlantı Hatası

İçeriğe ulaşılamıyor.

İnternet bağlantınızı kontrol edip tekrar deneyin.

{
  "videoErrorScreen": true,
  "media": {
    "mp4": [
      {
        "src": "https://nonexistent-domain.invalid/video.mp4",
        "type": "video/mp4",
        "label": "480P"
      }
    ]
  }
}

ERR_004MEDIA_ERR_SRC_NOT_SUPPORTED

Unsupported MIME type — browser cannot decode.

ERR_004

Desteklenmeyen Format

Bu içerik oynatılamıyor.

Sayfayı yenileyerek tekrar deneyebilirsiniz.

{
  "videoErrorScreen": true,
  "media": {
    "mp4": [
      {
        "src": "/fake.xyz",
        "type": "video/xyz-unsupported",
        "label": "480P"
      }
    ]
  }
}

ERR_005PENDING_TIMEOUT

Non-responsive URL — spinner shown after pendingTimeout ms.

ERR_005

Yükleniyor

İçerik yüklenmeye devam ediyor, lütfen bekleyin.

Bağlantı hızınıza bağlı olarak biraz daha sürebilir.

{
  "videoErrorScreen": true,
  "videoErrorScreenOptions": {
    "pendingTimeout": 3000,
    "pendingMaxWait": 12000
  },
  "media": {
    "mp4": [
      {
        "src": "http://example.com/pending.php",
        "type": "video/mp4",
        "label": "480P"
      }
    ]
  }
}

ERR_SRCSEARCHING_SOURCE

All sources fail — MediaRetry cycles through each before giving up.

ERR_SRC

Kaynak Aranıyor

Alternatif kaynaklar deneniyor, lütfen bekleyin.

{
  "videoErrorScreen": true,
  "videoErrorScreenOptions": {
    "retrySourceTimeout": 4000
  },
  "media": {
    "mp4": [
      {
        "src": "https://nonexistent.invalid/v1.mp4",
        "type": "video/mp4",
        "label": "1080P"
      },
      {
        "src": "https://nonexistent.invalid/v2.mp4",
        "type": "video/mp4",
        "label": "720P"
      },
      {
        "src": "https://nonexistent.invalid/v3.mp4",
        "type": "video/mp4",
        "label": "480P"
      }
    ]
  }
}

ERR_999UNKNOWN

Catch-all — undefined or unexpected error condition.

ERR_999

Bir Hata Oluştu

İçerik şu an oynatılamıyor.

Sorun devam ederse lütfen destek ekibiyle iletişime geçin.

{
  "videoErrorScreen": true,
  "media": {
    "mp4": [
      {
        "src": "about:blank",
        "type": "video/mp4",
        "label": "480P"
      }
    ]
  }
}

Config Reference

videoErrorScreen

boolean

Enables the branded error overlay.

videoErrorScreenOptions.pendingTimeout

number (ms)

Delay before the buffering spinner appears. Default: 3000.

videoErrorScreenOptions.pendingMaxWait

number (ms)

Max buffering wait — forces an error after this. Default: 8000.

videoErrorScreenOptions.retrySourceTimeout

number (ms)

How long MediaRetry waits per source before trying the next. Default: 5000.

Architecture

VideoErrorScreen

Pure display component. Renders overlays for each error type. Exposes show(type), showSearching(), showPending(), hide(). Does not listen to any player events.

MediaRetry

Listens to error, waiting, canplay events. Cycles through sources, manages pending timeouts, auto-resumes playback after a successful retry, and drives VideoErrorScreen to show the correct overlay at each stage.

Event Logs

HopeVideoJS is a flexible and customizable video player solution based on Video.js, developed by Umut Yaldız. It offers a modern and powerful media playback experience with its open-source structure.