☰

UserUtils

General purpose DOM/GreaseMonkey library: register listeners for when CSS selectors exist, intercept events, create persistent & synchronous data stores, modify the DOM more easily and much more

コードが変更されたバージョンのみを表示しています すべてのバージョンを表示

  • v10.4.0 2026/04/16
    • Minor Changes:
      • Updated to CoreUtils v3.6.0, which comes with the following minor features:
      • Added stringifyData option to DataStoreSerializer for preventing any stringification when serializing with the stringify parameter set to false too.
      • Added optional catchUpEvents option to NanoEmitter and NanoEmitterOptions. When provided with a list of event names, the emitter remembers the last arguments of each listed event. Any listener attached via on() or once() after such an event has already fired will be immediately called / resolved with the cached arguments. Also added the protected emitEvent() method for subclasses - it behaves identically to this.events.emit() but additionally updates the catch-up cache and should thus be preferred over this.events.emit().
      • Added function getterifyObj() to turn all own, enumerable properties of an object into getters. This is useful when logging large objects to the console.
      • Added optional TFn generic parameter to ValueGen and StringGen types, and a matching rest ...args parameter to consumeGen() and consumeStringGen(), enabling parametrized function variants with full type safety.
    • Patch Changes:
      • Fixed missing inclusion of .user.js file in NPM and JSR publish.
      • Fixed tsdoc comments for the properties of tr
  • v10.3.1 2026/03/11
    • Updated CoreUtils to v3.5.1 to fix a build error that led to a SyntaxError.
  • v10.3.0 2026/03/11
    • Updated CoreUtils to v3.5.0, which includes the following changes:
      • Added function createTable() to create a very flexible ASCII table, including ANSI color and %c styling support.
      • Fixed type variance issue in DataStoreSerializer where DataStore instances with specific data types (e.g. DataStore<MyType>) couldn't be passed to the constructor without being asserted as DataStore<DataStoreData, boolean>.
  • v10.2.0 2026/03/07
    • Updated CoreUtils to v3.4.0, which includes the following changes:
      • Debouncer and debounce now have an extra parameter of type NanoEmitterOptions to customize the underlying NanoEmitter instance.
      • Added function createRecurringTask() as a "batteries included" alternative to setImmediateTimeoutLoop() and setImmediateInterval(), with more ways to control task execution and aborting.
      • Fixed internal event emission problems in Debouncer
  • v10.1.0 2026/03/02

    Click here to view the full changelog for this version

    • Additions:
      • Added constant object versions to find out the versions of UserUtils and the bundled and re-exported CoreUtils library at runtime.
      • Added translation transform tr.transforms.i18n, which works similar to templateLiteral but matches the commonly used i18n pattern {{key}}
      • Added function tr.getAllTranslations() to return a mutable or immutable (default) object of all registered translations.
    • Changes:
      • Updated CoreUtils to v3.3.0. See its changelog for details.
      • An empty string can now be used as a valid translation language.
  • v10.0.6 2026/02/09
    • Made DataStore.getData() unavailable at the type level when memoryCache is set to false.
  • v10.0.5 2026/02/09
    • Added UMD bundle specifically for userscripts (at dist/UserUtils.user.js)
  • v10.0.4 2026/02/09
    • Click here to view the full changelog for this version
    • Moved a majority of the general-purpose code to the @sv443-network/coreutils package. The features are still accessible in this library in the same way, but some of them needed to be modified so they were more generic and consistent with the new package's codebase. Refer to the CoreUtils documentation for more information.
    • Reworked DataStore class
      • The constructor now needs an engine property that is an instance of a DataStoreEngine
      • Encoding using deflate-raw will now be enabled by default.
        If you're not using the encodeData and decodeData props, set compressionFormat: null to explicitly disable compression.
      • The properties encodeData and decodeData are now a tuple of a string format identifier (like gzip, deflate-raw, base64, etc.) and the respective function that used to be the only value of those properties.
      • Added DataStoreEngine class with three implementations available out-of-the-box; FileStorageEngine, BrowserStorageEngine and GMStorageEngine, for Node/Deno and two kinds of browser environments, respectively.
        Userscripts need to use either the GMStorageEngine or BrowserStorageEngine depending on whether they want to use GreaseMonkey storage (only accessible to the userscript) or standard browser storage (accessible by the website's scripts).
        Userscripts migrating from UserUtils v9 DataStores should use the GMStorageEngine to preserve all stored data.
      • Added shorthand property compressionFormat as an alternative to the properties encodeData and decodeData.
      • (The global key __ds_fmt_ver will now contain a global version number for DataStore-internal format integrity, stored via the given engine.)
    • Renamed functions
      • Renamed ab2str() to abtoa() and str2ab() to atoab() to match btoa() and atob()
      • Renamed purifyObj() to pureObj()
  • v9.4.4 2025/11/15
    • Fixed infinite recursion in translate() when using setFallbackLanguage()
    • Removed package.json engines field
  • v9.4.3 2025/06/29
    • Fixed can't convert trArgs[0] to string error
  • v9.4.2 2025/06/29
    • Fixed compatibility for translations with multiple transform function matches
  • v9.4.1 2025/03/31

    - Fixed include settings for JSR
  • v9.4.0 2025/03/31
    • Added Mixins class for allowing multiple sources to modify values in a controlled way
    • Added unit tests
    • Added Debouncer.getListeners() method to get an array of all listener functions
    • Added stores filter parameter to the DataStoreSerializer methods loadStoresData(), resetStoresData() and deleteStoresData()
    • Fixed error when calling interceptEvent() in a non-GM environment
  • v9.3.0 2025/03/21
    • Added DataStoreSerializer methods serializePartial() and deserializePartial() for partial data exports and imports
    • Added function purifyObj() to remove an object's prototype chain (i.e. omit all inherited properties like toString, __proto__, etc.)
  • v9.2.1 2025/03/14
    • Fixed TS type for DataStoreSerializer.serialize()
  • v9.2.0 2025/03/13
    • Added function isDomLoaded() to check if the DOM is queryable, regardless of @run-at setting
    • Added function roundFixed() to round a floating-point number to the given amount of decimals. Can also round to the given power of 10.
    • Added function probeElementStyle() to probe the computed style of a temporary element, allowing to resolve CSS variables and default style values, etc.
    • Added function onDomLoad() to call a callback and/or resolve a Promise when the DOM is loaded, even retroactively
    • Added function bitSetHas() to check if a given value is present in a bitset
    • Added parameter withDecimals to digitCount() (true by default)
    • Added custom error classes ChecksumMismatchError, DataMigrationError and PlatformError, extending from the base class UUError
      The base class has the additional property date which is the time of the error creation
    • Replaced a bunch of generic Errors with the new custom error class instances
  • v9.1.0 2025/02/09
    • Added the type ListWithLength to represent an array or object with a numeric length, count or size property.
    • Added autoPlural() support for generic objects with a numeric length, count or size property.
    • Added signal: AbortSignal and rejectOnAbort: boolean params to pauseFor() to allow for cutting the pause short
    • Support for words with -y/-ies extension in autoPlural()
    • Added getListLength() function to resolve a value of the new ListWithLength type
    • autoPlural() now defaults pluralType to "auto" and num to 2 if pluralType is invalid or num resolves to NaN
    • Fixed fetchAdvanced error "'abort' called on an object that does not implement interface AbortController"
  • v9.0.4 2025/01/23
    • Fix broken percent transform (tr.transforms.percent)
  • v9.0.3 2025/01/22
    • Fixed Debouncer TS types as to not break backwards compat
    • Fixed broken ambiguity of DataStore's migration function type
  • v9.0.2 2025/01/22
    • Fixed wrong readme being included in JSR package and added @module comments
  • v9.0.1 2025/01/22
    • Fixed missing return type signatures for JSR
  • v9.0.0 2025/01/22
    • BREAKING: Reworked translation system (see changelog for details)
    • BREAKING: Reworked debounce system (see changelog for details)
    • Added additionalProps parameter to openInNewTab() to add or overwrite anchor element props (only if GM.openInTab() is unavailable)
    • Moved documentation to separate file docs.md to speed up README.md load time.
    • Fixed newlines being collapsed in TSDoc comments.
    • Fixed randRange() with enhancedEntropy = true only returning the first digit.
  • v8.4.0 2024/12/22
    • Added function digitCount() to calculate the amount of digits in the passed number
    • Added support for nested objects in translations (e.g. tr("foo.bar.baz"))
    • Added ValueGen and StringGen types with accompanying consumeGen() and consumeStringGen() functions to allow for super flexible typing and declaration of values
    • Added overload to clamp() without min parameter
  • v8.3.3 2024/11/16
    • Made CJS bundle available on NPM too
  • v8.3.2 2024/11/11
    • Made CJS bundle available on JSR
  • v8.3.1 2024/11/11
    • Throw an error when calling interceptEvent() on window or unsafeWindow on FireMonkey instead of crashing the entire page
  • v8.3.0 2024/11/08
    • Added support for the signal property in fetchAdvanced()
  • v8.2.0 2024/11/08
    • Added overload to mapRange() that only needs both max values and assumes 0 for both min values
    • Added utility type Prettify to make complex types more readable
    • Added randomCase parameter to the function randomId() (true by default)
    • Added property migrateIds to the constructor of DataStore for easier ID migration
    • Added enhancedEntropy parameter to the function randRange() (false by default)
  • v8.1.0 2024/10/24
    • Added new DataStoreSerializer methods loadStoresData(), resetStoresData() and deleteStoresData() for parallelized bulk operations on DataStore instances
    • Added DataStore method migrateId() to be able to migrate to a new ID
  • v8.0.2 2024/09/16
    • Added exports.types in addition to just types in package.json
  • v8.0.1 2024/09/16
    • Added exports to package.json and corrected module property
  • v8.0.0 2024/09/04
    • Changed hexToRgb() and rgbToHex() to support #RGBA and #RRGGBBAA color codes (with an alpha channel).
      Both functions now have an alpha value immediately after blue, which can be set to undefined to restore the old behavior.
    • Added parameter upperCase (false by default) to lightenColor() and darkenColor()
    • Consolidated behavior of lightenColor() and darkenColor() when using non-number values
  • v7.3.0 2024/09/03
    • Added tr.forLang() to get the translation for a specified language code
    • Added tr.getTranslations() to return the translations object for the given or currently active language
  • v7.2.2 2024/08/29
    • Fixed color functions not being exported
  • v7.2.1 2024/08/28
    • Removed dev-only TypeScript shims which were accidentally included in the final bundle
  • v7.2.0 2024/08/28
    • Added color manipulation functions hexToRgb(), rgbToHex(), lightenColor() and darkenColor()
    • Added setInnerHtmlUnsafe() for setting innerHTML unsanitized using a Trusted Types policy
    • Made addGlobalStyle() use the new setInnerHtmlUnsafe() to fix the error "This document requires 'TrustedHTML' assignment" on Chromium-based browsers
  • v7.1.0 2024/08/08
    • Added Dialog class for easily creating customizable modal dialogs
    • Added NanoEmitter class for lightweight event emitter functionality in both object-oriented and functional programming styles
  • v7.0.0 2024/08/04
    • Removed the function insertAfter() because the DOM API already has the method insertAdjacentElement() that has the same functionality and even four positions to pick from.
      To get the same behavior as insertAfter(refElem, newElem), you can use refElem.insertAdjacentElement("afterend", newElem)
    • Added option checkInterval to SelectorObserver to check on interval instead of on mutation
    • Added DataStoreSerializer class for centralized and much easier and safer de-/serialization of any number of DataStore instances
    • SelectorObserver's addListener() now returns an unsubscribe function to more easily remove a listener
    • Added function computeHash() to calculate the hash / checksum of a string
    • DataStore: made runMigrations, encodeData and decodeData public and added encodingEnabled method
    • Made randomId() default to using Math.random() and added the parameter enhancedEntropy to revert back to the much slower but also much more entropic implementation
    • Added ability to change DataStore storage engine from default "GM" to "localStorage" and "sessionStorage"
  • v6.3.0 2024/04/06
    • Made openInNewTab() use GM.openInTab by default and fall back to the old behavior.
      Also added background param to specify if the tab should get focus when opened.
  • v6.2.0 2024/04/02
    • Add property to change the debounce edge in SelectorObserver instances
  • v6.1.0 2024/04/02
    • Added parameter to switch debounce() to trigger on the rising edge, instead of just the falling edge (see docs)
  • v6.0.1 2024/03/24
    • Fixed terminology in JSDoc comments of the DataStore class
  • v6.0.0 2024/03/23
    • Renamed ConfigManager to DataStore to make its implied purpose as a generic JSON database more clear.
      • the constructor property defaultConfig is now called defaultData
      • deleteConfig() is now called deleteData()
      • the internal GM storage keys will still have the prefix _uucfg for backwards compatibility
    • Added function getSiblingsFrame() that returns a frame of an element's siblings, with a given alignment and size
    • Lowered the Error.stackTraceLimit by a multiple of 10 to preserve memory
  • v5.0.1 2024/02/28
    • ConfigManager.loadData() now returns a copy of the data instead of a reference
  • v5.0.0 2024/02/20
    • compress() now uses the same value "string" (unlike previously "base64") for the outputType parameter like decompress()
    • Added encodeData() and decodeData() to the ConfigManager options to allow for easy data compression
  • v4.2.1 2024/02/16
    • Fixed TS types for overload of SelectorObserver constructor
  • v4.2.0 2024/02/16
    • Added SelectorObserver options disableOnNoListeners and enableOnAddListener
    • addGlobalStyle now returns the created style element
    • fetchAdvanced is now a drop-in replacement and timeout can now optionally be disabled
  • v4.1.0 2024/01/05

    - Added function `observeElementProp` to watch for a property of an element to change that isn't observable with MutationObserver
  • v4.0.0 2023/11/21
    • Removed amplifyMedia function due to massive inconsistencies in sound quality
    • Added functions compress and decompress to compress and decompress strings using gzip or deflate
    • Added TS utility types NonEmptyString and LooseUnion
    • Fixed wrong TS type for SelectorObserver options in constructor
  • v3.0.0 2023/11/12

    - `onSelector()` has been turned into the `SelectorObserver` class to reduce the performance impact on larger sites ([see migration info here](https://github.com/Sv443-Network/UserUtils/blob/main/CHANGELOG.md#300))
    - Removed the limiter from `amplifyMedia()` for clear and undistorted audio and renamed properties ([see migration info here](https://github.com/Sv443-Network/UserUtils/blob/main/CHANGELOG.md#300))
    - Added function `randomId()` to randomly generate cryptographically strong hexadecimal IDs
    - Added utility type `NonEmptyArray` for typing an array with at least 1 item

スクリプトのすべてのバージョンを表示