feat: add bitswap.unwant javascript spec

Author: wraithgar

SPEC/BITSWAP.md

@@ -3,7 +3,18 @@ Bitswap API
 
 #### `wantlist` (not spec'ed yet)
 
-#### `unwant` (not spec'ed yet)
+#### `unwant`
+
+> Removes a given block from your wantlist
+
+##### `Go` **WIP**
+
+##### `JavaScript` - ipfs.bitswap.unwant(cid)
+
+`cid` is a [cid][cid] which can be passed as:
+
+- CID, a CID instance
+- String, the base58 encoded version of the multihash
 
 #### `stat`
 

js/src/bitswap.js

@@ -0,0 +1,99 @@
+'use strict'
+
+const chai = require('chai')
+const dirtyChai = require('dirty-chai')
+const expect = chai.expect
+const statsTests = require('./utils/stats')
+chai.use(dirtyChai)
+const CID = require('cids')
+
+module.exports = (common) => {
+  describe('.bitswap online', () => {
+    let ipfs
+    const key = 'QmUBdnXXPyoDFXj3Hj39dNJ5VkN3QFRskXxcGaYFBB8CNR';
+
+    before(function (done) {
+      // CI takes longer to instantiate the daemon, so we need to increase the
+      // timeout for the before step
+      this.timeout(60 * 1000)
+
+      common.setup((err, factory) => {
+        expect(err).to.not.exist()
+        factory.spawnNode((err, node) => {
+          expect(err).to.not.exist()
+          ipfs = node
+          ipfs.block.get(new CID(key))
+            .then(() => {})
+            .catch(() => {})
+          setTimeout(done, 800)
+        })
+      })
+    })
+
+    after((done) => common.teardown(done))
+
+    it('.stat', (done) => {
+
+      ipfs.bitswap.stat((err, stats) => {
+        statsTests.expectIsBitswap(err, stats)
+        done()
+      })
+    })
+
+    it('.wantlist', (done) => {
+      const wantlist = ipfs.bitswap.wantlist()
+      expect(wantlist[0].cid.toBaseEncodedString()).to.equal(key)
+      done()
+    })
+
+    it('.unwant', (done) => {
+      ipfs.bitswap.unwant(new CID(key))
+      const wantlist = ipfs.bitswap.wantlist()
+      expect(wantlist).to.be.empty()
+      done()
+    })
+  })
+
+  describe('.bitswap offline', () => {
+    let ipfs
+
+    before(function (done) {
+      // CI takes longer to instantiate the daemon, so we need to increase the
+      // timeout for the before step
+      this.timeout(60 * 1000)
+
+      common.setup((err, factory) => {
+        expect(err).to.not.exist()
+        factory.spawnNode((err, node) => {
+          expect(err).to.not.exist()
+          ipfs = node
+          ipfs.id((err, id) => {
+            expect(err).to.not.exist()
+            ipfs.stop((err) => {
+              // TODO: go-ipfs returns an error, https://github.com/ipfs/go-ipfs/issues/4078
+              if (!id.agentVersion.startsWith('go-ipfs')) {
+                expect(err).to.not.exist()
+              }
+              done()
+            })
+          })
+        })
+      })
+    })
+
+    it('.stat gives error while offline', () => {
+      ipfs.bitswap.stat((err, stats) => {
+        expect(err).to.exist()
+        expect(stats).to.not.exist()
+      })
+    })
+
+    it('.wantlist throws if offline', () => {
+      expect(() => ipfs.bitswap.wantlist()).to.throw(/online/)
+    })
+
+    it('.unwant throws if offline', () => {
+      expect(() => ipfs.bitswap.unwant('my key')).to.throw(/online/)
+    })
+  })
+}

js/src/index.js

@@ -16,3 +16,4 @@ exports.key = require('./key')
 exports.stats = require('./stats')
 exports.repo = require('./repo')
 exports.bootstrap = require('./bootstrap')
+exports.bitswap = require('./bitswap')