What is pretty-easy-rgb-to-hex?
pretty-easy-rgb-to-hex is a simple NodeJS module for converting an RGB(a) color value to it's corresponding HEX value.
$ npm install pretty-easy-rgb-to-hex --save
After installing the module (localy in your project directory), in order to use it in your file you first need to require it.
let rgbToHEX = ;
or if you use TypeScript
The module returns a function for you to call and supply with an RGB(a) color value that you'd like to transform into its' corresponding HEX value. The function returns a String (HEX value, without a hash [#]) or an instance of Error class if the invalid color value was supplied to the function.
- HEX value returned does NOT include the hash [#] - this is intended!,
- no matter if alpha is passed or not the resulting HEX value will be 6 characters long - this is due to the nature of valid HEX color values that are either 3 or 6 characters long,
- HEX value returned is always 6 characters long,
- HEX color value returned consists of CAPITAL letters (no lowercase letters are returned),
- there are 4 valid ways of calling the function (see the example code below)
Convert RGB(a) color to HEX color
/** The module is flexible enough, as it allows you* to supply it with different RGB(a) color values,* no matter if it is a String, Number values, Object...** There are 4 valid ways of calling the function*/// Example 1. - single string value; // returns 'FF0000'; // returns 'FF0000'; // returns 'FF0000'; // returns 'FF0000'// Example 2. - 3 string values; // returns 'FF0000'// Example 3. - 3 number values; // returns 'FF0000'// Example 4. - RGB(a) object; // returns 'FF0000'; // returns 'FF0000'; // returns 'FF0000'
Consider the following
The module will return an instance of an Error class, if argument passed is not a valid RGB(a) color value, instead of throwing an error and terminating the Node process thus making it more dynamic and usable in production where you depend on the user input.
Having this in mind, I advise you to consider including a utility library, to check the output data type, such as pretty-easy-data-types.
/** Only import the checks you will be using,* instead of including the whole library*/constisString // check if the value supplied is of type StringisError // check for instance of an Error class} = ;const rgbToHEX = ;// You can pass any value/data type to a function,// without causing your process to breakconst convertToHex = ;/** After converting the RGB(a) color to its' corresponding HEX value* you should perform the check on the value returned and see* if the conversion was successful.** If the value returned is of type String the conversion was successful* and in this example we're going to prepend the hash symbol [#]* else it is an instance of an Error class* and we're just going to log it to the console*/const hexColor = ?`#` :convertToHex;if console;
Want to contribute?
Great! Anyone can help make this project better - check out the github repository!
Found a bug?
Please open a an issue.
Copyright (c) 2017 Ognjen Jevremović
Licensed under the MIT License.