Negotiation allows you to negotiate protocols between a client and server. This allows you to ship multiple versions of your protocol and have the server/client reach a agreement about which protocol to use. We do assume that the server has all possible protocols registered and that the client tells the server which versions they support.
We have a strong preference for binary protocols so when they are available we will prefer them over anything else.
The module was written to be compatible with Node.js and browserify. The release are pushed in the public npm registry and can therefor be installed from the CLI by executing:
npm install --save negotiation
Install today and get our revolutionary Binary Boost Bonus for free!
In all API examples we assume that you've pre-required the module and initialized the code as following:
'use strict';var Negotiation = ;n = ;
Register a new protocol in our
negotiation instance. This method accepts 2
- The name of the protocol that you're adding. This will also be used again in
idthat we're generating and returning in the
- The protocol that you register needs to be an object. This object should have
the following properties:
binaryBoolean that indicates if binary data is supported in the protocol, defaults to
versionVersion number of the protocol. Try to follow semver without pre-release tags and other kinds of bullshit. So just pure
x.x.xbased versioning as we parse out the numbers and generate score of it for sorting and ranking purposes. It defaults to
You can also add more properties as this object will be returned by the
The method returns it self so you can chain it.
Select a protocol out of the given list of supported protocols. This method accepts 2 arguments:
- Array of available protocols.
- Prefer boolean that indicates the preference of binary protocols over regular protocols. So even if they have a lower version number it will take the highest matching binary protocol.
var protocol = n;
If no available protocols are given we will check all our supported protocols
and return the one we prefer. If no matching protocol is found we will return
undefined all other matches will return the set
Return the id's of all available protocols that we send for the negotiation. By
default it will return all non binary protocols as we're unsure if the host
environment supports binary. If you want to include binary protocols pass in
true as first argument.
var list = n;var includingbinary = n;
This method will always return an array. Even if you didn't registry any protocols, it will just return an empty array.
Fully destroy the created
negotitation instance so it removes all references
engine. When you destroy it first the time it will return
true and the second
- next times it will return
falseas it was already destroyed.