This package has been deprecated

Author message:

You

teamspeak3-utils

Tools for Teamspeak 3 ServerQuery Client

Installation

$ npm install teamspeak3-utils --save

Note: TeamSpeak3 Utils is embedded into the TeamSpeak3 Client package.

Build your queries

The buildQuery method is an helper wich allow you to build easily your queries. The query is automaticly escaped and the result is returned.

If an error is occurred, the result is an instance of Error

let ts3utils = require('teamspeak3-utils')
let query = ts3utils.buildQuery('serveredit', {virtualserver_name:'TeamSpeak ]|[ Server'})

if(query instanceof Error) {
  console.log('Error: ' + query.message)
} else {
  console.log(query) // serveredit virtualserver_name=TeamSpeak\s]\p[\sServer  
}

Parse responses

The parseResponse method provide an easy way to treat your data.

let ts3utils = require('teamspeak3-utils')
let res = ts3utils.parseResponse('error id=0 msg=ok')

if(res instanceof Error) {
  console.log('Error: ' + query.message)
} else {
  console.log(res) // [ { error: '', id: 0, msg: 'ok' } ]
}

Definitions

The TeamSpeak 3 definitions are available in one object. You can use it to set easily your values.

let ts3defs = require('teamspeak3-utils/definitions')

console.log(ts3defs.CODEC_CRYPT_ENABLED) // 2

Retrieve client version/build

Since the version 1.4.0 i have introduced the list of client versions/builds for the desktop, android and ios, you can use it as you wish.

let TS3ClientVersions = require('teamspeak3-utils/client-versions')

Note: Sometime build can have several versions and version can have several builds, so the methods always return an array

You can easily get the builds for a specified client version with getClientBuildByVersion

let ts3utils = require('teamspeak3-utils')
let builds = ts3utils.getClientBuildByVersion('3.0.5', 'desktop')

if(builds instanceof Error) {
  console.log('Error: ' + builds.message)
} else {
  console.log(builds) // [1328254851, 1328791207, 1329129765, 1329301801]
}

and get the client versions for a specified build with getClientVersionByBuild

let ts3utils = require('teamspeak3-utils')
let versions = ts3utils.getClientBuildByVersion(1427190433, 'android')

if(versions instanceof Error) {
  console.log('Error: ' + versions.message)
} else {
  console.log(versions) // ['3.0.18', '3.0.18.1']
}

Escaping

All the escape & unescape methods have the same workaround, you provide a string and it returns the final string.

let ts3utils = require('teamspeak3-utils')

console.log(ts3utils.escape('Hello world!')) // Hello\\sworld!
console.log(ts3utils.unescape('Hello\\sworld!')) // Hello world!

You can use specifics methods if you need, here are the methods :

• escapeBackslashes / unescapeBackslashes
• escapeBell / unescapeBell
• escapeCarriagesReturns / unescapeCarriagesReturns
• escapeFormfeeds / unescapeFormfeeds
• escapeNewlines / unescapeNewlines
• escapePipes / unescapePipes
• unescapeSlashes / escapeSlashes
• escapeTabulations / unescapeTabulations
• escapeVerticalTabulations / unescapeVerticalTabulations
• escapeWhitespaces / unescapeWhitespaces

Bugs & suggestions

If you found bug or have any suggestion feel free to open a ticket