← 返回首页
userScripts.getScripts() - Mozilla | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Mozilla
  2. Add-ons
  3. Browser extensions
  4. JavaScript APIs
  5. userScripts
  6. userScripts.getScripts()
Theme
  • OS default
  • Light
  • Dark
English (US)
Remember language Learn more

userScripts.getScripts()

Returns user scripts registered by the extension.

In this article

Syntax

js
const gettingUserScripts = await browser.userScripts.getScripts( filter // object );

Parameters

filter Optional

userScripts.UserScriptFilter. A list of user script IDs to return.

Return value

A Promise fulfilled with an array of userScripts.RegisteredUserScript objects. If no matching user scripts are found, the array is empty. If the request fails, the promise is rejected with an error message.

Example extensions

Browser compatibility

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on Jul 17, 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Browser extensions
  2. Getting started
    1. What are extensions?
    2. Your first extension
    3. Your second extension
    4. Anatomy of an extension
    5. Example extensions
    6. What next?
  3. Concepts
    1. JavaScript APIs
    2. Content scripts
    3. Background scripts
    4. Match patterns
    5. Work with files
    6. Internationalization
    7. Content Security Policy
    8. Native messaging
    9. Native manifests
    10. User actions
    11. Differences between API implementations
    12. Chrome incompatibilities
  4. User interface
    1. Toolbar button
    2. Address bar button
    3. Sidebars
    4. Context menu items
    5. Options page
    6. Extension pages
    7. Notifications
    8. Address bar suggestions
    9. devtools panels
    10. Browser styles
    11. Popups
  5. How to
    1. Intercept HTTP requests
    2. Modify a web page
    3. Insert external content
    4. Share objects with page scripts
    5. Add a button to the toolbar
    6. Implement a settings page
    7. Work with the Tabs API
    8. Work with the Bookmarks API
    9. Work with the Cookies API
    10. Work with contextual identities
    11. Interact with the clipboard
    12. Use Web Authn API in web extensions
    13. Extend the developer tools
    14. Build a cross-browser extension
  6. JavaScript APIs
    1. Browser support for JavaScript APIs
    2. action
    3. alarms
    4. bookmarks
    5. browserAction
    6. browserSettings
    7. browsingData
    8. captivePortal
    9. clipboard
    10. commands
    11. contentScripts
    12. contextualIdentities
    13. cookies
    14. declarativeNetRequest
    15. devtools
    16. dns
    17. dom
    18. downloads
    19. events
    20. extension
    21. extensionTypes
    22. find
    23. history
    24. i18n
    25. identity
    26. idle
    27. management
    28. menus
    29. notifications
    30. omnibox
    31. pageAction
    32. permissions
    33. pkcs11
    34. privacy
    35. proxy
    36. runtime
    37. scripting
    38. search
    39. sessions
    40. sidebarAction
    41. storage
    42. tabGroups
    43. tabs
    44. theme
    45. topSites
    46. types
    47. userScripts
      1. Methods
        1. configureWorld()
        2. execute()
        3. getScripts()
        4. getWorldConfigurations()
        5. register()
        6. resetWorldConfiguration()
        7. unregister()
        8. update()
      2. Types
        1. ExecutionWorld
        2. RegisteredUserScript
        3. ScriptSource
        4. UserScriptFilter
        5. WorldProperties
    48. userScripts (Legacy)
    49. webNavigation
    50. webRequest
    51. windows
  7. Manifest keys
    1. action
    2. author
    3. background
    4. browser_action
    5. browser_specific_settings
    6. chrome_settings_overrides
    7. chrome_url_overrides
    8. commands
    9. content_scripts
    10. content_security_policy
    11. dark_theme
    12. declarative_net_request
    13. default_locale
    14. description
    15. developer
    16. devtools_page
    17. dictionaries
    18. externally_connectable
    19. homepage_url
    20. host_permissions
    21. icons
    22. incognito
    23. manifest_version
    24. name
    25. offline_enabled
    26. omnibox
    27. optional_host_permissions
    28. optional_permissions
    29. options_page
    30. options_ui
    31. page_action
    32. permissions
    33. protocol_handlers
    34. short_name
    35. sidebar_action
    36. storage
    37. theme
    38. theme_experiment
    39. user_scripts
    40. version
    41. version_name
    42. web_accessible_resources
  8. Extension Workshop
    1. Develop
    2. Publish
    3. Manage
    4. Enterprise
  9. Contact us
  10. Channels
    1. Add-ons blog
    2. Add-ons forum
    3. Add-ons chat

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.