Security News
The Push to Ban Ransom Payments Is Gaining Momentum
Ransomware costs victims an estimated $30 billion per year and has gotten so out of control that global support for banning payments is gaining momentum.
url-slug
Advanced tools
Readme
RFC 3986 compliant slug generator with multiple language support. It creates slugs safe for use in URL paths, queries and fragments, and can revert them too.
$ npm install url-slug
import urlSlug from 'url-slug'
urlSlug('Sir James Paul McCartney MBE is an English singer-songwriter')
// sir-james-paul-mc-cartney-mbe-is-an-english-singer-songwriter
Returns the string value converted to a slug.
The string that'll be converted.
Name | Description | Default |
---|---|---|
camelCase | Split camel case occurrences | true |
separator | Character to split the string: '-' , '.' , '_' , '~' or '' | '-' |
transformer | A built-in transformer or a custom function (set to false to keep the string unchanged) | urlSlug.transformers.lowercase |
import urlSlug from 'url-slug'
urlSlug('Comfortably Numb', {
transformer: urlSlug.transformers.uppercase
})
// COMFORTABLY-NUMB
urlSlug('á é í ó ú Á É Í Ó Ú ç Ç æ Æ œ Œ ® © € ¥ ª º ¹ ² ½ ¼', {
separator: '_',
transformer: false
})
// a_e_i_o_u_A_E_I_O_U_c_C_ae_AE_oe_OE_r_c_EU_Y_a_o_1_2_1_2_1_4
urlSlug('Red, red wine, stay close to me…', {
separator: '',
transformer: urlSlug.transformers.titlecase
})
// RedRedWineStayCloseToMe
⚠️ Warning: This syntax will be deprecated
Returns the string value converted to a slug.
Type: string
The string that'll be converted.
Type: string
The character used to separate the slug fragments, set to '-'
by default. Can be set to '-'
, '.'
, '_'
, '~'
or ''
.
Type: function
or false
A function that receives the slug fragments and the current separator as arguments. It must return the slug string. Defaults to the built-in transformer urlSlug.transformers.lowercase
. It can be set to false
if no transformation is desirable.
import urlSlug from 'url-slug'
urlSlug('Comfortably Numb', urlSlug.transformers.uppercase)
// COMFORTABLY-NUMB
urlSlug('á é í ó ú Á É Í Ó Ú ç Ç æ Æ œ Œ ® © € ¥ ª º ¹ ² ½ ¼', '_', false)
// a_e_i_o_u_A_E_I_O_U_c_C_ae_AE_oe_OE_r_c_EU_Y_a_o_1_2_1_2_1_4
urlSlug('Red, red wine, stay close to me…', '', urlSlug.transformers.titlecase)
// RedRedWineStayCloseToMe
Returns the slug value converted to a regular string.
The slug that'll be reverted.
Name | Description | Default |
---|---|---|
camelCase | Split camel case occurrences | false |
separator | Character to split the string: '-' , '.' , '_' , '~' or '' (set to null to use all characters) | null |
transformer | A built-in transformer or a custom function (set to false to keep the string unchanged) | false |
import urlSlug from 'url-slug'
urlSlug.revert('Replace-every_separator.allowed~andSplitCamelCaseToo')
// Replace every separator allowed and Split Camel Case Too
urlSlug.revert('this-title-needs-a-title_case', {
separator: '-',
transformer: urlSlug.transformers.titlecase
})
// This Title Needs A Title_case
⚠️ Warning: This syntax will be deprecated
Returns the slug value converted to a regular string.
Type: string
The slug that'll be reverted.
Type: string
or null
The value used to split the slug into fragments, set to null
by default. Can be set to null
, '-'
, '.'
, '_'
, '~'
or ''
. If set to null
, the split will happen on any valid separator character or camel case occurrences. If set to an empty string, only camel case occurrences will be split.
Type: function
or false
A function that receives the string fragments and the current separator as arguments. Defaults to false
, which means that no transformation will be made.
import urlSlug from 'url-slug'
urlSlug.revert('Replace-every_separator.allowed~andSplitCamelCaseToo')
// Replace every separator allowed and Split Camel Case Too
urlSlug.revert(
'this-title-needs-a-title_case',
'-',
urlSlug.transformers.titlecase
)
// This Title Needs A Title_case
⚠️ Warning: This syntax will be deprecated
url-slug
constructor, useful if you want to create more instances. If separator
or transform
are set, they will the default values of the instance.
Type: string
Defaults to '-'
. Can be set to '-'
, '.'
, '_'
, '~'
or ''
.
Type: function
or false
Defaults to urlSlug.transformers.lowercase
. Can be set to a function or false
, if no transformation is desired.
import urlSlug from 'url-slug'
const urlSlugInstance = new urlSlug.UrlSlug('~', urlSlug.transformers.uppercase)
urlSlugInstance.convert('Listen to Fito Páez in Madrid')
// LISTEN~TO~FITO~PAEZ~IN~MADRID
Custom transformers are expressed by a function which receives two arguments, fragments, an array with the resulting words of the conversion, and separator, the current separator string used to join the words. On revert, the separator will always be a space character (' '
). Transformers should always return a string.
import urlSlug from 'url-slug'
urlSlug(
'O\'Neill is an American surfboard, surfwear and equipment brand',
fragments => fragments.join('+').toUpperCase()
)
// O+NEILL+IS+AN+AMERICAN+SURFBOARD+SURFWEAR+AND+EQUIPMENT+BRAND
urlSlug.revert(
'WEIrd_SNAke_CAse',
'_',
(fragments, separator) => fragments.map(fragment => (
fragment.slice(0, -2).toLowerCase() + fragment.slice(-2).toUpperCase()
)).join(separator)
)
// weiRD snaKE caSE
Converts the result to lowercase.
Converts the result to uppercase.
Converts the result to title case.
FAQs
Slug generator with less than 1 KB and no dependencies, RFC 3986 compliant
We found that url-slug demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Ransomware costs victims an estimated $30 billion per year and has gotten so out of control that global support for banning payments is gaining momentum.
Application Security
New SEC disclosure rules aim to enforce timely cyber incident reporting, but fear of job loss and inadequate resources lead to significant underreporting.
Security News
The Python Software Foundation has secured a 5-year sponsorship from Fastly that supports PSF's activities and events, most notably the security and reliability of the Python Package Index (PyPI).