4.0.0 • Published 4 years ago

spotify-wrapper-3 v4.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
4 years ago

Spotify Wrapper

Build Status

project for Javascript and TDD studies (with jasmine)

Course:https://www.udemy.com/course/js-com-tdd-na-pratica by Willian Justen

A wrapper to work with the Spotify Web API.

Browser Support

This library relies on Fetch API. And this API is supported in the following browsers.

ChromeFirefoxOperaSafariIE
39+ ✔42+ ✔29+ ✔10.1+ ✔Nope ✘

Dependencies

This library depends on fetch to make requests to the Spotify Web API. For environments that don't support fetch, you'll need to provide a polyfill to browser or polyfill to Node.

Installation

How to use

ES6

// to import a specific method
import { method } from 'spotify-wrapper';

// to import everything
import * as spotifyWrapper from 'spotify-wrapper';

CommonJS

var spotifyWrapper = require('spotify-wrapper');

UMD in Browser

<!-- to import non-minified version -->
<script src="spotify-wrapper.umd.js"></script>

<!-- to import minified version -->
<script src="spotify-wrapper.umd.min.js"></script>

After that the library will be available to the Global as spotifyWrapper. Follow an example:

const albums = spotifyWrapper.searchAlbums('Choosen Artist');

Methods

Follow the methods that the library provides.

search(query, types)

Search for informations about artists, albums, tracks or playlists. Test in Spotify Web Console.

Arguments

ArgumentTypeOptions
querystring'Any search query'
typeArray of strings'artist', 'album', 'track', 'playlist'

Example

search('Incubus', ['artist', 'album']).then((data) => {
  // do what you want with the data
});

searchAlbums(query)

Search for informations about Albums with provided query. Test in Spotify Web Console with type defined as album.

Arguments

ArgumentTypeOptions
querystring'Any search query'

Example

searchAlbums('Incubus').then((data) => {
  // do what you want with the data
});

getAlbum(id)

Search for informations about a specific Album with provided id. Test in Spotify Web Console.

Arguments

ArgumentTypeOptions
idstring'Specific id'

Example

getAlbum('4aawyAB9vmqN3uQ7FjRGTy').then((data) => {
  // do what you want with the data
});

getAlbums(ids)

Search for informations about some Albums with all id's. Test in Spotify Web Console.

Arguments

ArgumentTypeOptions
idsArray of strings'id1', 'id2'

Example

getAlbumById(['4aawyAB9vmqN3uQ7FjRGTy', '1A2GTWGtFfWp7KSQTwWOyo']).then((data) => {
  // do what you want with the data
});

License

This project is licensed under the MIT License - see the LICENSE.md file for details

4.0.0

4 years ago

3.0.0

4 years ago

2.0.0

4 years ago

1.0.0

4 years ago