EasySpotify - A Spotify Web Api JS Wrapper
This is a JavaScript library that wraps Spotify Web API to make your life easier.
Browser Support
This library relies on Fetch API, which is supported in the following browsers:
42+ ✔ | 40+ ✔ | 29+ ✔ | 10.1+ ✔ | Nope ✘ | 14+ ✔ | 10.3+ ✔ |
For more detailed information, see caniuse.com.
Installation and Usage
This library depends on fetch to make requests. For environments that don't support fetch, like NodeJS or older browser, you'll need to provide a polyfill.
NodeJS
Install both node-fetch polyfill and easy-spotify:
terminal
$ npm install node-fetch easy-spotify --save
app.js
// set node-fetch as global.fetch before anythingglobalfetch = ;// now you can use the libraryconst EasySpotify = ;const spotify = token: 'your-token-here';
Browser
Install easy-spotify from npm and require it from /dist folder.
index.html
<!-- import default version --><!-- or import minified version --><!-- <script src="node_modules/easy-spotify/dist/easy-spotify.umd.min.js"></script> --><!-- import your js file -->
app.js
let easySpotify = token: 'your-token-here'
Examples
To see examples, refer to the examples folder.
Methods
This library is still in development (so as the documentation), but all methods are documented in JSDoc format. If your editor support JSDoc, then you can see type information and all methods for EasySpotify object.
Built With
Ideas to Implement
- Add configurations to paginate some requests, like getAlbums, search, searchTracks
- Support Artists endpoints
- Support Browse endpoints
- Support Follow endpoints
- Support Library endpoints
- Support Personalization endpoints
- Support Player endpoints
- Support Playlists endpoints
- Support Tracks endpoints
- Support User Profiles endpoints
- Find a way to get a OAuth token (don't think that is possible with js only)
Authors
Bruno Lombardi |
License
This project is licensed under the MIT License - see the LICENSE.md file for details
Acknowledgments
- 1000 thanks to Willian Justen who teachs everything about how to make this library in his awesome Udemy Course, only portuguese :(
- The whole project this code is based on, spotify-wrapper