Update URLs, comments and ES5 -> ES6 (#253)

Author: dandv

examples/access-token-refresh.js

@@ -1,32 +1,33 @@
-var SpotifyWebApi = require('../');
+const SpotifyWebApi = require('../');
 
 /**
  * This example refreshes an access token. Refreshing access tokens is only possible access tokens received using the
  * Authorization Code flow, documented here: https://developer.spotify.com/spotify-web-api/authorization-guide/#authorization_code_flow
  */
 
-/* Retrieve a code as documented here:
- * https://developer.spotify.com/spotify-web-api/authorization-guide/#authorization_code_flow
+/* Retrieve an authorization code as documented here:
+ * https://developer.spotify.com/documentation/general/guides/authorization-guide/#authorization-code-flow
+ * or in the Authorization section of the README.
  *
  * Codes are given for a set of scopes. For this example, the scopes are user-read-private and user-read-email.
  * Scopes are documented here:
- * https://developer.spotify.com/spotify-web-api/using-scopes/
+ * https://developer.spotify.com/documentation/general/guides/scopes/
  */
-var authorizationCode =
-  'AQAgjS78s64u1axMCBCRA0cViW_ZDDU0pbgENJ_-WpZr3cEO7V5O-JELcEPU6pGLPp08SfO3dnHmu6XJikKqrU8LX9W6J11NyoaetrXtZFW-Y58UGeV69tuyybcNUS2u6eyup1EgzbTEx4LqrP_eCHsc9xHJ0JUzEhi7xcqzQG70roE4WKM_YrlDZO-e7GDRMqunS9RMoSwF_ov-gOMpvy9OMb7O58nZoc3LSEdEwoZPCLU4N4TTJ-IF6YsQRhQkEOJK';
+const authorizationCode =
+  '<insert authorization code with user-read-private and user-read-email scopes>';
 
 /**
- * Set the credentials given on Spotify's My Applications page.
- * https://developer.spotify.com/my-applications
+ * Get the credentials from Spotify's Dashboard page.
+ * https://developer.spotify.com/dashboard/applications
  */
-var spotifyApi = new SpotifyWebApi({
+const spotifyApi = new SpotifyWebApi({
   clientId: '<insert client id>',
   clientSecret: '<insert client secret>',
   redirectUri: '<insert redirect URI>'
 });
 
 // When our access token will expire
-var tokenExpirationEpoch;
+let tokenExpirationEpoch;
 
 // First retrieve an access token
 spotifyApi.authorizationCodeGrant(authorizationCode).then(
@@ -53,7 +54,7 @@ spotifyApi.authorizationCodeGrant(authorizationCode).then(
 );
 
 // Continually print out the time left until the token expires..
-var numberOfTimesUpdated = 0;
+let numberOfTimesUpdated = 0;
 
 setInterval(function() {
   console.log(

examples/access-token-using-client-credentials.js

@@ -1,19 +1,15 @@
-var SpotifyWebApi = require('../');
+const SpotifyWebApi = require('../');
 
 /**
- * This example retrives an access token using the Client Credentials Flow. It's well documented here:
- * https://developer.spotify.com/web-api/authorization-guide/#client_credentials_flow
- */
-
-/*
- * https://developer.spotify.com/spotify-web-api/using-scopes/
+ * This example retrieves an access token using the Client Credentials Flow, documented at:
+ * https://developer.spotify.com/documentation/general/guides/authorization-guide/#client-credentials-flow
  */
 
 /**
- * Set the credentials given on Spotify's My Applications page.
- * https://developer.spotify.com/my-applications
+ * Get the credentials from Spotify's Dashboard page.
+ * https://developer.spotify.com/dashboard/applications
  */
-var spotifyApi = new SpotifyWebApi({
+const spotifyApi = new SpotifyWebApi({
   clientId: '<insert client id>',
   clientSecret: '<insert client secret>'
 });

examples/add-remove-replace-tracks-in-a-playlist.js

@@ -1,34 +1,33 @@
-var SpotifyWebApi = require('../');
+const SpotifyWebApi = require('../');
 
 /**
- * This example demonstrates adding tracks, removing tracks, and replacing tracks in a playlist. At this time of writing this
- * documentation, this is the available playlist track modification features in the Spotify Web API.
+ * This example demonstrates adding tracks, removing tracks, and replacing tracks in a playlist. At the time of writing this
+ * documentation, this is the available playlist track modification feature in the Spotify Web API.
  *
  * Since authorization is required, this example retrieves an access token using the Authorization Code Grant flow,
- * documented here: https://developer.spotify.com/spotify-web-api/authorization-guide/#authorization_code_flow
+ * documented here: https://developer.spotify.com/documentation/general/guides/authorization-guide/#authorization-code-flow
  *
  * Codes are given for a set of scopes. For this example, the scopes are playlist-modify-public.
  * Scopes are documented here:
- * https://developer.spotify.com/spotify-web-api/using-scopes/
+ * https://developer.spotify.com/documentation/general/guides/scopes/
  */
 
-/* This code is hardcoded. For a working implementation, the code needs to be retrieved from the user. See documentation about
- * the Authorization Code flow for more information.
+/* Obtain the `authorizationCode` below as described in the Authorization section of the README.
  */
-var authorizationCode =
+const authorizationCode =
   '<insert authorization code with playlist-modify-public scope>';
 
 /**
- * Set the credentials given on Spotify's My Applications page.
- * https://developer.spotify.com/my-applications
+ * Get the credentials from Spotify's Dashboard page.
+ * https://developer.spotify.com/dashboard/applications
  */
-var spotifyApi = new SpotifyWebApi({
+const spotifyApi = new SpotifyWebApi({
   clientId: '<insert client id>',
   clientSecret: '<insert client secret>',
   redirectUri: '<insert redirect URI>'
 });
 
-var playlistId;
+let playlistId;
 
 // First retrieve an access token
 spotifyApi
@@ -81,6 +80,5 @@ spotifyApi
     console.log('Ok. Tracks replaced!');
   })
   .catch(function(err) {
-    console.log(err.message);
-    console.log('Something went wrong!');
+    console.log('Something went wrong:', err.message);
   });

examples/add-tracks-to-a-playlist.js

@@ -1,26 +1,25 @@
-var SpotifyWebApi = require('../');
+const SpotifyWebApi = require('../');
 
 /**
  * This example demonstrates adding tracks to a specified position in a playlist.
  *
  * Since authorization is required, this example retrieves an access token using the Authorization Code Grant flow,
- * documented here: https://developer.spotify.com/spotify-web-api/authorization-guide/#authorization_code_flow
+ * documented here: https://developer.spotify.com/documentation/general/guides/authorization-guide/#authorization-code-flow
  *
  * Codes are given for a set of scopes. For this example, the scopes are playlist-modify-public.
  * Scopes are documented here:
- * https://developer.spotify.com/spotify-web-api/using-scopes/
+ * https://developer.spotify.com/documentation/general/guides/scopes/
  */
 
-/* This code is hardcoded. For a working implementation, the code needs to be retrieved from the user. See documentation about
- * the Authorization Code flow for more information.
+/* Obtain the `authorizationCode` below as described in the Authorization section of the README.
  */
-var authorizationCode = '<insert authorization code>';
+const authorizationCode = '<insert authorization code>';
 
 /**
- * Set the credentials given on Spotify's My Applications page.
- * https://developer.spotify.com/my-applications
+ * Get the credentials from Spotify's Dashboard page.
+ * https://developer.spotify.com/dashboard/applications
  */
-var spotifyApi = new SpotifyWebApi({
+const spotifyApi = new SpotifyWebApi({
   clientId: '<insert client id>',
   clientSecret: '<insert client secret>',
   redirectUri: '<insert redirect URI>'
@@ -46,5 +45,5 @@ spotifyApi
     console.log('Added tracks to the playlist!');
   })
   .catch(function(err) {
-    console.log('Something went wrong!', err.message);
+    console.log('Something went wrong:', err.message);
   });

examples/get-info-about-current-user.js

@@ -1,24 +1,24 @@
-var SpotifyWebApi = require('../');
+const SpotifyWebApi = require('../');
 
 /**
  * This example retrieves information about the 'current' user. The current user is the user that has
  * authorized the application to access its data.
  */
 
 /* Retrieve a code as documented here:
- * https://developer.spotify.com/spotify-web-api/authorization-guide/#authorization_code_flow
+ * https://developer.spotify.com/documentation/general/guides/authorization-guide/#authorization-code-flow
  *
  * Codes are given for a set of scopes. For this example, the scopes are user-read-private and user-read-email.
  * Scopes are documented here:
- * https://developer.spotify.com/spotify-web-api/using-scopes/
+ * https://developer.spotify.com/documentation/general/guides/scopes/
  */
-var authorizationCode =
-  'AQAgjS78s64u1axMCBCRA0cViW_ZDDU0pbgENJ_-WpZr3cEO7V5O-JELcEPU6pGLPp08SfO3dnHmu6XJikKqrU8LX9W6J11NyoaetrXtZFW-Y58UGeV69tuyybcNUS2u6eyup1EgzbTEx4LqrP_eCHsc9xHJ0JUzEhi7xcqzQG70roE4WKM_YrlDZO-e7GDRMqunS9RMoSwF_ov-gOMpvy9OMb7O58nZoc3LSEdEwoZPCLU4N4TTJ-IF6YsQRhQkEOJK';
+const authorizationCode =
+  '<insert authorization code with user-read-private and user-read-email scopes>';
 
-/* Set the credentials given on Spotify's My Applications page.
- * https://developer.spotify.com/my-applications
+/* Get the credentials from Spotify's Dashboard page.
+ * https://developer.spotify.com/dashboard/applications
  */
-var spotifyApi = new SpotifyWebApi({
+const spotifyApi = new SpotifyWebApi({
   clientId: '<insert client id>',
   clientSecret: '<insert client secret>',
   redirectUri: '<insert redirect URI>'
@@ -50,5 +50,5 @@ spotifyApi
     console.log('This user has a ' + data.body.product + ' account');
   })
   .catch(function(err) {
-    console.log('Something went wrong', err.message);
+    console.log('Something went wrong:', err.message);
   });

examples/get-related-artists.js

@@ -24,6 +24,6 @@ spotifyApi.getArtistRelatedArtists(artistId).then(
     }
   },
   function(err) {
-    console.log('Something went wrong..', err.message);
+    console.log('Something went wrong:', err.message);
   }
 );

examples/get-top-tracks-for-artist.js

@@ -1,8 +1,8 @@
-var SpotifyWebApi = require('../');
+const SpotifyWebApi = require('../');
 
 /**
  * This example retrieves the top tracks for an artist.
- * https://developer.spotify.com/spotify-web-api/get-artists-top-tracks/
+ * https://developer.spotify.com/documentation/web-api/reference/artists/get-artists-top-tracks/
  */
 
 /**
@@ -11,9 +11,9 @@ var SpotifyWebApi = require('../');
  *
  * Since it's not necessary to get an access token connected to a specific user, this example
  * uses the Client Credentials flow. This flow uses only the client ID and the client secret.
- * https://developer.spotify.com/spotify-web-api/authorization-guide/#client_credentials_flow
+ * https://developer.spotify.com/documentation/general/guides/authorization-guide/#client-credentials-flow
  */
-var spotifyApi = new SpotifyWebApi({
+const spotifyApi = new SpotifyWebApi({
   clientId: '<insert client id>',
   clientSecret: '<insert client secret>'
 });

examples/search-for-tracks.js

@@ -39,9 +39,7 @@ spotifyApi
 
     // Go through the first page of results
     var firstPage = data.body.tracks.items;
-    console.log(
-      'The tracks in the first page are.. (popularity in parentheses)'
-    );
+    console.log('The tracks in the first page are (popularity in parentheses):');
 
     /*
      * 0: All of Me (97)
@@ -52,7 +50,6 @@ spotifyApi
     firstPage.forEach(function(track, index) {
       console.log(index + ': ' + track.name + ' (' + track.popularity + ')');
     });
-  })
-  .catch(function(err) {
+  }).catch(function(err) {
     console.log('Something went wrong:', err.message);
   });