概念：使用

簡單的承諾

儘管本文檔的目的不是教您如何編寫JavaScript Promise，了解如何使用它們，看看如何簡單Promise被編碼。

在下面，Promise將創建一個返回字符串，該字符串指出任務是否已完成。關鍵是Promise.resolve()要么Promise.reject()方法被調用。在這種情況下，兩個方法都傳遞了一個簡單的字符串，但這可能是一個對象。

          let promiseToFinishTask = new Promise(function(resolve, reject) {
          
            //Business logic to set taskComplete boolean
            let taskComplete = true;
          
            if (taskComplete) {
              resolve('Yea, I am done');
            } else {
              reject('Not quite done');
            }
          });

現在您將看到如何處理退貨Promise信息，這是您對某些Brightcove Player API方法調用所做的操作。基本的處理如下：

          promiseName.then(
            // Function call for promise resolved
          ).catch(
            // Function call for promise rejected
          )

處理上面的簡單示例如下所示：

          promiseToFinishTask.then(function(fromResolve) {
            console.log(fromResolve);
          }).catch(function(fromReject) {
            console.log(fromReject);
          });

如果Promise解決了then代碼已執行，如果Promise被拒絕了catch代碼被執行。例如，字符串之一Yea, I am done要么Not quite done將根據設置taskComplete變量的值。

Brightcove的例子

Brightcove玩家的play()方法可能會返回一個Promise，可用於檢查播放器是否可以自動播放播放器中當前的視頻。處理Promise突出顯示：

          var myPlayer = videojs.getPlayer('myPlayerID');
          myPlayer.on('loadedmetadata',function() {
            var promise = myPlayer.play();
            if (promise !== undefined) {
              promise.then(function() {
                // Autoplay started!
              }).catch(function(error) {
                // Autoplay was prevented.
              });
            }
          });

基於此，您可以然後編碼是否自動播放視頻的行為。有關播放視頻和音頻的特定用例，請參見具體用例的部分自動播放注意事項文件。

有關JavaScript承諾的完整信息，請參見MDN承諾文件。

Promise與回調

在本節中，目錄的get()方法用於演示使用Promise與回調函數。的get()方法可以與任何一種方法一起使用。

無極語法

以下是顯示對的調用的代碼段get()方法，將響應作為Promise：

          myPlayer.catalog.get(catalogParams).then(function(videosReturned){
            console.log('videosReturned',videosReturned);
            myPlayer.playlist(videosReturned);
          }).catch(function(errorObj){
            console.log('errorObj',errorObj);
          })

回調函數語法

以下是顯示對的調用的代碼段get()方法，使用回調函數處理響應：

            myPlayer.catalog.get(catalogParams,function(errorObj,videosReturned){
            console.log('errorObj',errorObj);
            console.log('videosReturned',videosReturned);
            myPlayer.playlist(videosReturned);
          });