@mkody/twitch-emoticons 2.7.0 → 2.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.eslintrc.json +143 -143
- package/.github/codeql/codeql-config.yml +4 -4
- package/.github/workflows/codeql.yml +50 -50
- package/.github/workflows/eslint.yml +50 -50
- package/.github/workflows/release.yml +22 -0
- package/.github/workflows/yarn-test.yml +17 -17
- package/.jsdoc.json +39 -39
- package/.nvmrc +1 -0
- package/LICENSE +22 -22
- package/docs/BTTVEmote.html +1319 -1319
- package/docs/Channel.html +823 -823
- package/docs/Collection.html +797 -797
- package/docs/Emote.html +801 -801
- package/docs/EmoteFetcher.html +2946 -2946
- package/docs/EmoteParser.html +811 -811
- package/docs/FFZEmote.html +1473 -1473
- package/docs/SevenTV.html +1190 -1190
- package/docs/SevenTVEmote.html +1395 -1395
- package/docs/TwitchEmote.html +1315 -1315
- package/docs/index.html +206 -206
- package/docs/struct_BTTVEmote.js.html +132 -132
- package/docs/struct_Channel.js.html +127 -127
- package/docs/struct_Emote.js.html +138 -138
- package/docs/struct_EmoteFetcher.js.html +395 -399
- package/docs/struct_EmoteParser.js.html +153 -153
- package/docs/struct_FFZEmote.js.html +146 -146
- package/docs/struct_SevenTVEmote.js.html +141 -141
- package/docs/struct_TwitchEmote.js.html +130 -130
- package/docs/util_Collection.js.html +150 -150
- package/package.json +57 -57
- package/src/index.js +12 -12
- package/src/struct/BTTVEmote.js +60 -60
- package/src/struct/Channel.js +55 -55
- package/src/struct/Emote.js +66 -66
- package/src/struct/EmoteFetcher.js +323 -327
- package/src/struct/EmoteParser.js +81 -81
- package/src/struct/FFZEmote.js +74 -74
- package/src/struct/SevenTVEmote.js +69 -69
- package/src/struct/TwitchEmote.js +58 -58
- package/src/util/Collection.js +78 -78
- package/src/util/Constants.js +31 -31
- package/test/index.js +174 -174
- package/typings/index.d.ts +98 -98
package/docs/index.html
CHANGED
|
@@ -1,207 +1,207 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="en">
|
|
3
|
-
<head>
|
|
4
|
-
|
|
5
|
-
<meta charset="utf-8">
|
|
6
|
-
<title>Home - Documentation</title>
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
<script src="scripts/prettify/prettify.js"></script>
|
|
10
|
-
<script src="scripts/prettify/lang-css.js"></script>
|
|
11
|
-
<!--[if lt IE 9]>
|
|
12
|
-
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
|
|
13
|
-
<![endif]-->
|
|
14
|
-
<link type="text/css" rel="stylesheet" href="styles/prettify.css">
|
|
15
|
-
<link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
|
|
16
|
-
<script src="scripts/nav.js" defer></script>
|
|
17
|
-
|
|
18
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
19
|
-
</head>
|
|
20
|
-
<body>
|
|
21
|
-
|
|
22
|
-
<input type="checkbox" id="nav-trigger" class="nav-trigger" />
|
|
23
|
-
<label for="nav-trigger" class="navicon-button x">
|
|
24
|
-
<div class="navicon"></div>
|
|
25
|
-
</label>
|
|
26
|
-
|
|
27
|
-
<label for="nav-trigger" class="overlay"></label>
|
|
28
|
-
|
|
29
|
-
<nav >
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
<h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="BTTVEmote.html">BTTVEmote</a><ul class='methods'><li data-type='method'><a href="BTTVEmote.html#toLink">toLink</a></li><li data-type='method'><a href="BTTVEmote.html#toString">toString</a></li></ul></li><li><a href="Channel.html">Channel</a><ul class='methods'><li data-type='method'><a href="Channel.html#fetchBTTVEmotes">fetchBTTVEmotes</a></li><li data-type='method'><a href="Channel.html#fetchFFZEmotes">fetchFFZEmotes</a></li><li data-type='method'><a href="Channel.html#fetchSevenTVEmotes">fetchSevenTVEmotes</a></li></ul></li><li><a href="Collection.html">Collection</a><ul class='methods'><li data-type='method'><a href="Collection.html#filter">filter</a></li><li data-type='method'><a href="Collection.html#find">find</a></li><li data-type='method'><a href="Collection.html#map">map</a></li></ul></li><li><a href="Emote.html">Emote</a><ul class='methods'><li data-type='method'><a href="Emote.html#toString">toString</a></li></ul></li><li><a href="EmoteFetcher.html">EmoteFetcher</a><ul class='methods'><li data-type='method'><a href="EmoteFetcher.html#_cacheBTTVEmote">_cacheBTTVEmote</a></li><li data-type='method'><a href="EmoteFetcher.html#_cacheFFZEmote">_cacheFFZEmote</a></li><li data-type='method'><a href="EmoteFetcher.html#_cacheSevenTVEmote">_cacheSevenTVEmote</a></li><li data-type='method'><a href="EmoteFetcher.html#_cacheTwitchEmote">_cacheTwitchEmote</a></li><li data-type='method'><a href="EmoteFetcher.html#_getRawBTTVEmotes">_getRawBTTVEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#_getRawFFZEmoteSet">_getRawFFZEmoteSet</a></li><li data-type='method'><a href="EmoteFetcher.html#_getRawFFZEmotes">_getRawFFZEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#_getRawSevenTVEmotes">_getRawSevenTVEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#_getRawTwitchEmotes">_getRawTwitchEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#fetchBTTVEmotes">fetchBTTVEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#fetchFFZEmotes">fetchFFZEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#fetchSevenTVEmotes">fetchSevenTVEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#fetchTwitchEmotes">fetchTwitchEmotes</a></li></ul></li><li><a href="EmoteParser.html">EmoteParser</a><ul class='methods'><li data-type='method'><a href="EmoteParser.html#parse">parse</a></li></ul></li><li><a href="FFZEmote.html">FFZEmote</a><ul class='methods'><li data-type='method'><a href="FFZEmote.html#toLink">toLink</a></li><li data-type='method'><a href="FFZEmote.html#toString">toString</a></li></ul></li><li><a href="SevenTVEmote.html">SevenTVEmote</a><ul class='methods'><li data-type='method'><a href="SevenTVEmote.html#toLink">toLink</a></li><li data-type='method'><a href="SevenTVEmote.html#toString">toString</a></li></ul></li><li><a href="TwitchEmote.html">TwitchEmote</a><ul class='methods'><li data-type='method'><a href="TwitchEmote.html#toLink">toLink</a></li><li data-type='method'><a href="TwitchEmote.html#toString">toString</a></li></ul></li></ul>
|
|
33
|
-
|
|
34
|
-
</nav>
|
|
35
|
-
|
|
36
|
-
<div id="main">
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
<section class="package">
|
|
47
|
-
<h3>@mkody/twitch-emoticons 2.7.
|
|
48
|
-
</section>
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
<section class="readme usertext">
|
|
63
|
-
<article><h1>twitch-emoticons</h1>
|
|
64
|
-
<p>Gets Twitch, BTTV, FFZ and 7TV emotes as well as parsing text to emotes!</p>
|
|
65
|
-
<h3>Migrating from upstream</h3>
|
|
66
|
-
<p>You must now use a Twitch user ID instead of the username to fetch user's emotes.<br>
|
|
67
|
-
You can use <a href="https://s.kdy.ch/twitchid/">this page to quickly grab it</a>.</p>
|
|
68
|
-
<p>To fetch Twitch emotes you need to get a client and secret from Twitch <a href="https://dev.twitch.tv/console/apps/create">here</a>, it's free.<br>
|
|
69
|
-
If you are only using BetterTTV, FrankerFaceZ and 7TV you don't need to provide Twitch app keys as they are independent from the Twitch API.</p>
|
|
70
|
-
<h3>Install</h3>
|
|
71
|
-
<pre class="prettyprint source lang-sh"><code>npm install @mkody/twitch-emoticons
|
|
72
|
-
# or
|
|
73
|
-
yarn add @mkody/twitch-emoticons
|
|
74
|
-
</code></pre>
|
|
75
|
-
<h3>Examples</h3>
|
|
76
|
-
<h4>Basic Twitch emote parsing</h4>
|
|
77
|
-
<pre class="prettyprint source lang-js"><code>// With ESM import
|
|
78
|
-
import TwitchEmoticons from '@mkody/twitch-emoticons';
|
|
79
|
-
const { EmoteFetcher, EmoteParser } = TwitchEmoticons;
|
|
80
|
-
// ... or require()
|
|
81
|
-
const { EmoteFetcher, EmoteParser } = require('@mkody/twitch-emoticons');
|
|
82
|
-
|
|
83
|
-
// Your Twitch app keys
|
|
84
|
-
const clientId = '<your client id>';
|
|
85
|
-
const clientSecret = '<your client secret>';
|
|
86
|
-
|
|
87
|
-
const fetcher = new EmoteFetcher(clientId, clientSecret);
|
|
88
|
-
const parser = new EmoteParser(fetcher, {
|
|
89
|
-
type: 'markdown',
|
|
90
|
-
match: /:(.+?):/g
|
|
91
|
-
});
|
|
92
|
-
|
|
93
|
-
fetcher.fetchTwitchEmotes(null).then(() => {
|
|
94
|
-
const kappa = fetcher.emotes.get('Kappa').toLink();
|
|
95
|
-
console.log(kappa);
|
|
96
|
-
// https://static-cdn.jtvnw.net/emoticons/v2/25/default/dark/1.0
|
|
97
|
-
|
|
98
|
-
const text = 'Hello :CoolCat:!';
|
|
99
|
-
const parsed = parser.parse(text);
|
|
100
|
-
console.log(parsed);
|
|
101
|
-
// Hello !
|
|
102
|
-
});
|
|
103
|
-
</code></pre>
|
|
104
|
-
<h4>All providers, global + channel, custom template and match pattern</h4>
|
|
105
|
-
<pre class="prettyprint source lang-js"><code>const { EmoteFetcher, EmoteParser } = require('@mkody/twitch-emoticons');
|
|
106
|
-
|
|
107
|
-
// Your channel ID
|
|
108
|
-
const channelId = 44317909;
|
|
109
|
-
|
|
110
|
-
// Your Twitch app keys
|
|
111
|
-
const clientId = '<your client id>';
|
|
112
|
-
const clientSecret = '<your client secret>';
|
|
113
|
-
|
|
114
|
-
const fetcher = new EmoteFetcher(clientId, clientSecret);
|
|
115
|
-
const parser = new EmoteParser(fetcher, {
|
|
116
|
-
// Custom HTML format
|
|
117
|
-
template: '<img class="emote" alt="{name}" src="{link}">',
|
|
118
|
-
// Match without :colons:
|
|
119
|
-
match: /(\w+)+?/g
|
|
120
|
-
});
|
|
121
|
-
|
|
122
|
-
Promise.all([
|
|
123
|
-
// Twitch global
|
|
124
|
-
fetcher.fetchTwitchEmotes(),
|
|
125
|
-
// Twitch channel
|
|
126
|
-
fetcher.fetchTwitchEmotes(channelId),
|
|
127
|
-
// BTTV global
|
|
128
|
-
fetcher.fetchBTTVEmotes(),
|
|
129
|
-
// BTTV channel
|
|
130
|
-
fetcher.fetchBTTVEmotes(channelId),
|
|
131
|
-
// 7TV global
|
|
132
|
-
fetcher.fetchSevenTVEmotes(),
|
|
133
|
-
// 7TV channel
|
|
134
|
-
fetcher.fetchSevenTVEmotes(channelId),
|
|
135
|
-
// FFZ global
|
|
136
|
-
fetcher.fetchFFZEmotes(),
|
|
137
|
-
// FFZ channel
|
|
138
|
-
fetcher.fetchFFZEmotes(channelId)
|
|
139
|
-
]).then(() => {
|
|
140
|
-
const globalEmotes = parser.parse('EZ Clap way too easy LUL now for the last boss monkaS LaterSooner');
|
|
141
|
-
console.log(globalEmotes);
|
|
142
|
-
// <img class="emote" alt="EZ" src="https://cdn.7tv.app/emote/63071b80942ffb69e13d700f/1x.webp"> <img class="emote" alt="Clap" src="https://cdn.7tv.app/emote/62fc0a0c4a75fd54bd3520a9/1x.webp"> way too easy <img class="emote" alt="LUL" src="https://static-cdn.jtvnw.net/emoticons/v2/425618/default/dark/1.0"> now for the last boss <img class="emote" alt="monkaS" src="https://cdn.betterttv.net/emote/56e9f494fff3cc5c35e5287e/1x.webp"> <img class="emote" alt="LaterSooner" src="https://cdn.frankerfacez.com/emote/149346/1">
|
|
143
|
-
|
|
144
|
-
const channelEmotes = parser.parse('KEKW that was 3Head TeriPoint');
|
|
145
|
-
console.log(channelEmotes);
|
|
146
|
-
// <img class="emote" alt="KEKW" src="https://cdn.betterttv.net/emote/5e9c6c187e090362f8b0b9e8/1x.webp"> that was <img class="emote" alt="3Head" src="https://cdn.frankerfacez.com/emote/274406/1"> <img class="emote" alt="TeriPoint" src="https://cdn.7tv.app/emote/61dc299b600369a98b38ebef/1x.webp">
|
|
147
|
-
}).catch(err => {
|
|
148
|
-
console.error('Error loading emotes...');
|
|
149
|
-
console.error(err);
|
|
150
|
-
});
|
|
151
|
-
</code></pre>
|
|
152
|
-
<h4>7TV formats</h4>
|
|
153
|
-
<p>7TV v3 delivers emotes in either WEBP or AVIF.<br>
|
|
154
|
-
By default we'll return WEBP emotes but you can override this.</p>
|
|
155
|
-
<pre class="prettyprint source lang-js"><code>const { EmoteFetcher } = require('@mkody/twitch-emoticons');
|
|
156
|
-
const fetcher = new EmoteFetcher();
|
|
157
|
-
|
|
158
|
-
// Fetch global emotes in AVIF (channel id has to be `null` for global)
|
|
159
|
-
fetcher.fetchSevenTVEmotes(null, 'avif');
|
|
160
|
-
|
|
161
|
-
// Fetch 0kody's emotes with the package's default format (WEBP)
|
|
162
|
-
fetcher.fetchSevenTVEmotes(44317909);
|
|
163
|
-
|
|
164
|
-
// ... which is currently the same as
|
|
165
|
-
fetcher.fetchSevenTVEmotes(44317909, 'webp');
|
|
166
|
-
|
|
167
|
-
// Fetch Anatole's emotes in AVIF
|
|
168
|
-
fetcher.fetchSevenTVEmotes(24377667, 'avif');
|
|
169
|
-
</code></pre>
|
|
170
|
-
<h3>Links</h3>
|
|
171
|
-
<ul>
|
|
172
|
-
<li><a href="https://github.com/mkody/twitch-emoticons">Github</a></li>
|
|
173
|
-
<li><a href="https://mkody.github.io/twitch-emoticons/">Documentation</a></li>
|
|
174
|
-
<li><a href="https://github.com/mkody/twitch-emoticons/releases">Changelog</a></li>
|
|
175
|
-
</ul>
|
|
176
|
-
<p>This library uses the following:</p>
|
|
177
|
-
<ul>
|
|
178
|
-
<li><a href="https://twurple.js.org/">Twurple</a> and the <a href="https://dev.twitch.tv/">Twitch API</a></li>
|
|
179
|
-
<li><a href="https://betterttv.com/developers/api">BetterTTV API</a></li>
|
|
180
|
-
<li><a href="https://api.frankerfacez.com/docs/">FrankerFaceZ API</a></li>
|
|
181
|
-
<li><a href="https://7tv.io/">7TV API</a></li>
|
|
182
|
-
</ul></article>
|
|
183
|
-
</section>
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
</div>
|
|
193
|
-
|
|
194
|
-
<br class="clear">
|
|
195
|
-
|
|
196
|
-
<footer>
|
|
197
|
-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.2</a> using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
|
|
198
|
-
</footer>
|
|
199
|
-
|
|
200
|
-
<script>prettyPrint();</script>
|
|
201
|
-
<script src="scripts/polyfill.js"></script>
|
|
202
|
-
<script src="scripts/linenumber.js"></script>
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
</body>
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
|
|
5
|
+
<meta charset="utf-8">
|
|
6
|
+
<title>Home - Documentation</title>
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
<script src="scripts/prettify/prettify.js"></script>
|
|
10
|
+
<script src="scripts/prettify/lang-css.js"></script>
|
|
11
|
+
<!--[if lt IE 9]>
|
|
12
|
+
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
|
|
13
|
+
<![endif]-->
|
|
14
|
+
<link type="text/css" rel="stylesheet" href="styles/prettify.css">
|
|
15
|
+
<link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
|
|
16
|
+
<script src="scripts/nav.js" defer></script>
|
|
17
|
+
|
|
18
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
19
|
+
</head>
|
|
20
|
+
<body>
|
|
21
|
+
|
|
22
|
+
<input type="checkbox" id="nav-trigger" class="nav-trigger" />
|
|
23
|
+
<label for="nav-trigger" class="navicon-button x">
|
|
24
|
+
<div class="navicon"></div>
|
|
25
|
+
</label>
|
|
26
|
+
|
|
27
|
+
<label for="nav-trigger" class="overlay"></label>
|
|
28
|
+
|
|
29
|
+
<nav >
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
<h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="BTTVEmote.html">BTTVEmote</a><ul class='methods'><li data-type='method'><a href="BTTVEmote.html#toLink">toLink</a></li><li data-type='method'><a href="BTTVEmote.html#toString">toString</a></li></ul></li><li><a href="Channel.html">Channel</a><ul class='methods'><li data-type='method'><a href="Channel.html#fetchBTTVEmotes">fetchBTTVEmotes</a></li><li data-type='method'><a href="Channel.html#fetchFFZEmotes">fetchFFZEmotes</a></li><li data-type='method'><a href="Channel.html#fetchSevenTVEmotes">fetchSevenTVEmotes</a></li></ul></li><li><a href="Collection.html">Collection</a><ul class='methods'><li data-type='method'><a href="Collection.html#filter">filter</a></li><li data-type='method'><a href="Collection.html#find">find</a></li><li data-type='method'><a href="Collection.html#map">map</a></li></ul></li><li><a href="Emote.html">Emote</a><ul class='methods'><li data-type='method'><a href="Emote.html#toString">toString</a></li></ul></li><li><a href="EmoteFetcher.html">EmoteFetcher</a><ul class='methods'><li data-type='method'><a href="EmoteFetcher.html#_cacheBTTVEmote">_cacheBTTVEmote</a></li><li data-type='method'><a href="EmoteFetcher.html#_cacheFFZEmote">_cacheFFZEmote</a></li><li data-type='method'><a href="EmoteFetcher.html#_cacheSevenTVEmote">_cacheSevenTVEmote</a></li><li data-type='method'><a href="EmoteFetcher.html#_cacheTwitchEmote">_cacheTwitchEmote</a></li><li data-type='method'><a href="EmoteFetcher.html#_getRawBTTVEmotes">_getRawBTTVEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#_getRawFFZEmoteSet">_getRawFFZEmoteSet</a></li><li data-type='method'><a href="EmoteFetcher.html#_getRawFFZEmotes">_getRawFFZEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#_getRawSevenTVEmotes">_getRawSevenTVEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#_getRawTwitchEmotes">_getRawTwitchEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#fetchBTTVEmotes">fetchBTTVEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#fetchFFZEmotes">fetchFFZEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#fetchSevenTVEmotes">fetchSevenTVEmotes</a></li><li data-type='method'><a href="EmoteFetcher.html#fetchTwitchEmotes">fetchTwitchEmotes</a></li></ul></li><li><a href="EmoteParser.html">EmoteParser</a><ul class='methods'><li data-type='method'><a href="EmoteParser.html#parse">parse</a></li></ul></li><li><a href="FFZEmote.html">FFZEmote</a><ul class='methods'><li data-type='method'><a href="FFZEmote.html#toLink">toLink</a></li><li data-type='method'><a href="FFZEmote.html#toString">toString</a></li></ul></li><li><a href="SevenTVEmote.html">SevenTVEmote</a><ul class='methods'><li data-type='method'><a href="SevenTVEmote.html#toLink">toLink</a></li><li data-type='method'><a href="SevenTVEmote.html#toString">toString</a></li></ul></li><li><a href="TwitchEmote.html">TwitchEmote</a><ul class='methods'><li data-type='method'><a href="TwitchEmote.html#toLink">toLink</a></li><li data-type='method'><a href="TwitchEmote.html#toString">toString</a></li></ul></li></ul>
|
|
33
|
+
|
|
34
|
+
</nav>
|
|
35
|
+
|
|
36
|
+
<div id="main">
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
<section class="package">
|
|
47
|
+
<h3>@mkody/twitch-emoticons 2.7.1</h3>
|
|
48
|
+
</section>
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
<section class="readme usertext">
|
|
63
|
+
<article><h1>twitch-emoticons</h1>
|
|
64
|
+
<p>Gets Twitch, BTTV, FFZ and 7TV emotes as well as parsing text to emotes!</p>
|
|
65
|
+
<h3>Migrating from upstream</h3>
|
|
66
|
+
<p>You must now use a Twitch user ID instead of the username to fetch user's emotes.<br>
|
|
67
|
+
You can use <a href="https://s.kdy.ch/twitchid/">this page to quickly grab it</a>.</p>
|
|
68
|
+
<p>To fetch Twitch emotes you need to get a client and secret from Twitch <a href="https://dev.twitch.tv/console/apps/create">here</a>, it's free.<br>
|
|
69
|
+
If you are only using BetterTTV, FrankerFaceZ and 7TV you don't need to provide Twitch app keys as they are independent from the Twitch API.</p>
|
|
70
|
+
<h3>Install</h3>
|
|
71
|
+
<pre class="prettyprint source lang-sh"><code>npm install @mkody/twitch-emoticons
|
|
72
|
+
# or
|
|
73
|
+
yarn add @mkody/twitch-emoticons
|
|
74
|
+
</code></pre>
|
|
75
|
+
<h3>Examples</h3>
|
|
76
|
+
<h4>Basic Twitch emote parsing</h4>
|
|
77
|
+
<pre class="prettyprint source lang-js"><code>// With ESM import
|
|
78
|
+
import TwitchEmoticons from '@mkody/twitch-emoticons';
|
|
79
|
+
const { EmoteFetcher, EmoteParser } = TwitchEmoticons;
|
|
80
|
+
// ... or require()
|
|
81
|
+
const { EmoteFetcher, EmoteParser } = require('@mkody/twitch-emoticons');
|
|
82
|
+
|
|
83
|
+
// Your Twitch app keys
|
|
84
|
+
const clientId = '<your client id>';
|
|
85
|
+
const clientSecret = '<your client secret>';
|
|
86
|
+
|
|
87
|
+
const fetcher = new EmoteFetcher(clientId, clientSecret);
|
|
88
|
+
const parser = new EmoteParser(fetcher, {
|
|
89
|
+
type: 'markdown',
|
|
90
|
+
match: /:(.+?):/g
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
fetcher.fetchTwitchEmotes(null).then(() => {
|
|
94
|
+
const kappa = fetcher.emotes.get('Kappa').toLink();
|
|
95
|
+
console.log(kappa);
|
|
96
|
+
// https://static-cdn.jtvnw.net/emoticons/v2/25/default/dark/1.0
|
|
97
|
+
|
|
98
|
+
const text = 'Hello :CoolCat:!';
|
|
99
|
+
const parsed = parser.parse(text);
|
|
100
|
+
console.log(parsed);
|
|
101
|
+
// Hello !
|
|
102
|
+
});
|
|
103
|
+
</code></pre>
|
|
104
|
+
<h4>All providers, global + channel, custom template and match pattern</h4>
|
|
105
|
+
<pre class="prettyprint source lang-js"><code>const { EmoteFetcher, EmoteParser } = require('@mkody/twitch-emoticons');
|
|
106
|
+
|
|
107
|
+
// Your channel ID
|
|
108
|
+
const channelId = 44317909;
|
|
109
|
+
|
|
110
|
+
// Your Twitch app keys
|
|
111
|
+
const clientId = '<your client id>';
|
|
112
|
+
const clientSecret = '<your client secret>';
|
|
113
|
+
|
|
114
|
+
const fetcher = new EmoteFetcher(clientId, clientSecret);
|
|
115
|
+
const parser = new EmoteParser(fetcher, {
|
|
116
|
+
// Custom HTML format
|
|
117
|
+
template: '<img class="emote" alt="{name}" src="{link}">',
|
|
118
|
+
// Match without :colons:
|
|
119
|
+
match: /(\w+)+?/g
|
|
120
|
+
});
|
|
121
|
+
|
|
122
|
+
Promise.all([
|
|
123
|
+
// Twitch global
|
|
124
|
+
fetcher.fetchTwitchEmotes(),
|
|
125
|
+
// Twitch channel
|
|
126
|
+
fetcher.fetchTwitchEmotes(channelId),
|
|
127
|
+
// BTTV global
|
|
128
|
+
fetcher.fetchBTTVEmotes(),
|
|
129
|
+
// BTTV channel
|
|
130
|
+
fetcher.fetchBTTVEmotes(channelId),
|
|
131
|
+
// 7TV global
|
|
132
|
+
fetcher.fetchSevenTVEmotes(),
|
|
133
|
+
// 7TV channel
|
|
134
|
+
fetcher.fetchSevenTVEmotes(channelId),
|
|
135
|
+
// FFZ global
|
|
136
|
+
fetcher.fetchFFZEmotes(),
|
|
137
|
+
// FFZ channel
|
|
138
|
+
fetcher.fetchFFZEmotes(channelId)
|
|
139
|
+
]).then(() => {
|
|
140
|
+
const globalEmotes = parser.parse('EZ Clap way too easy LUL now for the last boss monkaS LaterSooner');
|
|
141
|
+
console.log(globalEmotes);
|
|
142
|
+
// <img class="emote" alt="EZ" src="https://cdn.7tv.app/emote/63071b80942ffb69e13d700f/1x.webp"> <img class="emote" alt="Clap" src="https://cdn.7tv.app/emote/62fc0a0c4a75fd54bd3520a9/1x.webp"> way too easy <img class="emote" alt="LUL" src="https://static-cdn.jtvnw.net/emoticons/v2/425618/default/dark/1.0"> now for the last boss <img class="emote" alt="monkaS" src="https://cdn.betterttv.net/emote/56e9f494fff3cc5c35e5287e/1x.webp"> <img class="emote" alt="LaterSooner" src="https://cdn.frankerfacez.com/emote/149346/1">
|
|
143
|
+
|
|
144
|
+
const channelEmotes = parser.parse('KEKW that was 3Head TeriPoint');
|
|
145
|
+
console.log(channelEmotes);
|
|
146
|
+
// <img class="emote" alt="KEKW" src="https://cdn.betterttv.net/emote/5e9c6c187e090362f8b0b9e8/1x.webp"> that was <img class="emote" alt="3Head" src="https://cdn.frankerfacez.com/emote/274406/1"> <img class="emote" alt="TeriPoint" src="https://cdn.7tv.app/emote/61dc299b600369a98b38ebef/1x.webp">
|
|
147
|
+
}).catch(err => {
|
|
148
|
+
console.error('Error loading emotes...');
|
|
149
|
+
console.error(err);
|
|
150
|
+
});
|
|
151
|
+
</code></pre>
|
|
152
|
+
<h4>7TV formats</h4>
|
|
153
|
+
<p>7TV v3 delivers emotes in either WEBP or AVIF.<br>
|
|
154
|
+
By default we'll return WEBP emotes but you can override this.</p>
|
|
155
|
+
<pre class="prettyprint source lang-js"><code>const { EmoteFetcher } = require('@mkody/twitch-emoticons');
|
|
156
|
+
const fetcher = new EmoteFetcher();
|
|
157
|
+
|
|
158
|
+
// Fetch global emotes in AVIF (channel id has to be `null` for global)
|
|
159
|
+
fetcher.fetchSevenTVEmotes(null, 'avif');
|
|
160
|
+
|
|
161
|
+
// Fetch 0kody's emotes with the package's default format (WEBP)
|
|
162
|
+
fetcher.fetchSevenTVEmotes(44317909);
|
|
163
|
+
|
|
164
|
+
// ... which is currently the same as
|
|
165
|
+
fetcher.fetchSevenTVEmotes(44317909, 'webp');
|
|
166
|
+
|
|
167
|
+
// Fetch Anatole's emotes in AVIF
|
|
168
|
+
fetcher.fetchSevenTVEmotes(24377667, 'avif');
|
|
169
|
+
</code></pre>
|
|
170
|
+
<h3>Links</h3>
|
|
171
|
+
<ul>
|
|
172
|
+
<li><a href="https://github.com/mkody/twitch-emoticons">Github</a></li>
|
|
173
|
+
<li><a href="https://mkody.github.io/twitch-emoticons/">Documentation</a></li>
|
|
174
|
+
<li><a href="https://github.com/mkody/twitch-emoticons/releases">Changelog</a></li>
|
|
175
|
+
</ul>
|
|
176
|
+
<p>This library uses the following:</p>
|
|
177
|
+
<ul>
|
|
178
|
+
<li><a href="https://twurple.js.org/">Twurple</a> and the <a href="https://dev.twitch.tv/">Twitch API</a></li>
|
|
179
|
+
<li><a href="https://betterttv.com/developers/api">BetterTTV API</a></li>
|
|
180
|
+
<li><a href="https://api.frankerfacez.com/docs/">FrankerFaceZ API</a></li>
|
|
181
|
+
<li><a href="https://7tv.io/">7TV API</a></li>
|
|
182
|
+
</ul></article>
|
|
183
|
+
</section>
|
|
184
|
+
|
|
185
|
+
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
|
|
190
|
+
|
|
191
|
+
|
|
192
|
+
</div>
|
|
193
|
+
|
|
194
|
+
<br class="clear">
|
|
195
|
+
|
|
196
|
+
<footer>
|
|
197
|
+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.2</a> using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
|
|
198
|
+
</footer>
|
|
199
|
+
|
|
200
|
+
<script>prettyPrint();</script>
|
|
201
|
+
<script src="scripts/polyfill.js"></script>
|
|
202
|
+
<script src="scripts/linenumber.js"></script>
|
|
203
|
+
|
|
204
|
+
|
|
205
|
+
|
|
206
|
+
</body>
|
|
207
207
|
</html>
|