依赖选择器

依赖选择器语法和查询

描述

npm query 命令公开了一种新的依赖选择器语法(由 & 尊重 CSS 选择器 4 规范 的许多方面提供信息),它:

  • 使用健壮的对象模型、元数据和选择器语法标准化依赖图的形状和查询
  • 利用 CSS 中现有的已知语言语法和运算符来广泛访问不同的包信息
  • 解锁回答有关依赖关系、它们的关系和关联元数据的复杂、多方面问题的能力
  • 整合 npm 中类似查询命令的冗余逻辑(例如npm fund, npm ls, npm outdated, npm audit ...)

依赖选择器语法 v1.0.0

概述

  • 没有 "type" 或 "tag" 选择器(例如。div, h1, a) 作为依赖项/目标是唯一可以查询的 Node 类型
  • "dependencies" 一词是指在 Arborist 返回的 tree 中找到的任何 Node

组合器

  • > 直系后代/子代
  • 任何后代/孩子
  • ~ 兄弟姐妹

选择器

    +VuGqYuBUebMojrAscTHDTxxB6eLC5l60QR40q4iDDwJ3l3syPvCov7Nz+J0jfAZw9nHMXOoEinam8313LqUBgsDMgIi5rJIP0yZeBktrEr1ZaTZERj7Yqh7YseDRg0Ypuow7VHYS54ergUn1IA06Lvryph4RSbzq1NaObOewXcw8/MC0aRzwibvN6zhd1fjd70edxk725iBF4Qh6H+PcLBhf2J54PmILB01bZOzTLvkT+I+YYKbg/pkRAdQ4izCrI92CO0hvMAAWYtDqbqObgsFP9O5Oy8wKfMdMguOf0OTeuCiyy/LTlJnIh03s10FKyHfjhCm0O0afV2+2H78w88t7dYRWKi8brUpoBfZUZi+YIKMYJFchwFpcjYE0xyVigAzwc8pVBL1+jzPG8kW/Ub1+v34YHayXtdqbZHnICL0mC5zwB7q/pYFvRJ7lxCcHkPNjoI3cbdsQco0M1ej4Y8chnSRvyWU0bfCS9BzxP3Xj1fjs6NWGOaZu86SmUHsDjIqGyJk90Z4XX6iITO9Cg==

依赖类型选择器

    qHpUw5HlIqM+6IjlALzmvAsHcXKgjc06ifee0jPkMCGKMqZVM6S4tEA/jaQndwu+Vy5B0GJXGit52nsNKHiJhlw2uqWNjpE1+jLm4ZGbhGn0kArrrqCGMtpMc0fz/k6nm0tAR4ggkMaWgczejbpQPO6sqwH5IiKVUp3FK138ExEVa8xMLnxLlwqFQlh6I9rfGZt0CccJfNRAhJmJRh36BhG3lfj4Rv1aNpPEFlNeG5OiEfx3dkMLRWz/XvTbLvMyUQ/T0Zbf1J9+ceBUtG5BXyIMBx/dbvv0NyHFx44phB+Apu8ScHQZ1c8XhwbweeRyyTu0WD4rwEKt2TyZquyGfKIQr/Pe2vz6PfD/NxqmVVPKKNlrn+790LhCYRbLfA4dGvfhYCognKqPMn2LOUxwDb/lW35lidAoyuYyi/QDhyTFMNAD12y4WjgfQLhQKZ+viVvZuF+NxdrrqDGEzuxg7VG/GL+zKWdh0xWtQm5//nJueGhHMQNEtlQdrXUm3ALBMTKDAxJkTasTlifX20l+TPzueM0M1ePeCut6i+0n5FUUUqhzUoA/i3GtFFEM3nmrzMy8Ohlden10hTBR3145ZLN0mgS4gy2m2tV/sfIwg8iebFupQno9v2FVOnPSbCpCAOS2iOgVds/Yoom6Cvhl6/X60TAZd1VNZ0MLVJHvpDtbdAs9aZKB63pkr0Ou9q1xYMrwHYhQFhti62yGhAiKADQvHy4gEHfzAgpiuFVk2i8w2p1BC13kiRYOtsv90arx3QpznbksjVMxmnf0Vf/TgvE+iR5Bu5oJsGjz+KLXz7vQ02NBPsWmXG7ZNHIZGKHIdS2ePVZ44uIQzct2xd/IDxykeISSu+FIvUyJt5666Rg8YoSI0j53X0h0Vwk10GwC4mslXHT+NBSJ5jF+HUDV+3I7fqE6uQoS/mtND7/wmrODEZ0jX7ai6kpOvymanoxNfZcaG/DMJj4SR8W/1smfsdSlLBLpBZ5C/AzKLB2eJN1i0aeAY/Q7+Lkg5LL8fhhhSlXTnAooqyoF5AJ2CYE5+GEncO86g2LEYeTiJgumEHsbvvuGqCxLt0HgxNrkO8P7mnkDk9MxMsgzAkuDRmf9D0f844mhhHU2FSg8CdZ/sEkEl7zI+VUAcdCEK/uVBu1B5nZuCG9+wrkmG9mS1j5xH5zAoGkBEZ/lX7Z24R3zeW8ETvNlSqRR4FAZMqI75NSVN2p7zrxTME49scsh/nIRsJLfvzQpSU5o/Jxb4+YpKxKfogaJMqhmUtiNdlHViRlf2RRfZdp7s3yOpj6wbWaj7vlhcAcmGb4VgfM5yr8wRaELnoUTmt6dMENa8JsuFpNu9C7BDsk8XeJszr9Ctp7QaivZ41A3JEHzMlz+aJtq/cp3U8yHHHZ4PvVRygQiQ4kM

伪选择器

    sm7seZWsVv4dXJb5Vzr8TJWs7BUGGLeZrxwu1A13t3v/0wPCvQORE3/Q1uLShMobOwEaSimyeNyHqBTcA3Oqk37rGNYvTWNRwwReIF117kmh61Tqog+IRWLiEo5PCbnilw1DKpSzar/281edwS2svaVWlIAdtSegUTA86XDagpcUdFI8+5EL4o6zUkqtfrNoMhHO2tV+RcnLq2HpY2SFj5gWtmNYfMzy8F+VTlj7kjtxxBlGgjnrj3fkM7iKOG0TtDnZ56FPLunXWqp05AWTwaXnaIOWpzy94Ojm2+lLGTj+0aYap2VdW/XL/uFp6QSvG0t0xcpsNzXS4ZquLkVG8ggNoqJrO5OOgKW5eSd+vAh7bSh/bKdCaFHnwwanjmRuZWYPUuxiTdJRR6rRxN1v9nSEA9h9hudffoy0VdeGspKiO2CXUiavq52D7lTuqBWhAkRJWUSFcCrZRO18E07htyc71dez/0pMQFHgoRoeFI5y4hQ/hcTENgExP3AZYBqXiNDbxDvE9GIt2vmqQrvTfkA+9Nh7BfneWr4lGO01phtKMhT4pJgMTT6ikurt6zR6P2rHuiuJ+oODHchrIww9m/LDzO9A39lwVuhP1cE5gezJNP7cW3b1KfbgkcwtvjzvHP+Lzd3QVXctl1dzu02tULAE1wWmps6guRW4iMbkbDpbXVfQsZ+ToCNi4lO5gj9hi7EO13kg26mydnqqldmv00Lc9bICxpGZiR9v74zH5YJfvbAtaXwLS4q/KERwwmzK/B7MrYsXL6X7x+p7+QcZDhaF4llMn4pLhICkitP524jtk8g/WsyFm8PV4wrUbAQLWHI6A2rHEUiXRA8LzPbxPRL3jAEocP+dzaO2YdikSSxIpzUG35ql/zLEiAZqBWJbzaKrJOF1y+xCvFjdFyrW6zzxuSb9FCH20JDgrqJa3gQXF/BRIxfVNp3K8VDosKUjpV2Eqf++ibRlZynmr2jeC31qyww+oTE5O5t1eypEThVgNL3ZMYgfco3AAAQHdbacO+X+B80oF12mcn5sQQWNIK97t57xBDIaObjr+Hv+kj9NtLtRY+DCoMoLCPtjeKY46xI/slZfloIXNDTlZbyG4vPK2gq5oohjkjWjxe7KG31e6tb8KTFOYFOPUUKLo22iXqjnvD1p3KgSGWGCB7NB5nM1D3zMjtAmzYXvGJ+6LlwrNxjfiM3dBsrTkdleeRpoFTk05eN9fsQ1gcpnL059b2lnvBoRXapDjJBiiHqwN55tLywK+F13efhvf7PPjS0tYBT0vxh48/0EVKUjPnPuyLAUY7tgdMAgTN8BpY6RY7Hw2TEuMNVXa4uP5WM0y1bc7NuLlyomn+FFHFf/BVYRv3KFW6j1WPIgeD4+cfTBBv5e7phB0a/1ohroZloUOshvmaK38oz7upy04wspeqcrtoEDJ0V/XyZ/HoX3kaCg4tldJg/I3X7oqsKVWIbRuBwrGZ96aQlylcFa8O3JdZkXhQUyy8Qn9VoFd6TSkdl8np3vwI6gc9hGBf2f7z/l/KAjZKWa17ky23K13R+Th0Wf6d5lodg/wGfaQuf9/+ivq1+0VpLyPZ26tXAFePb1ezctQvmYWhJzzRt6GfOX7Jt72iHp+GPiybQhDxeicz70YoLOQ0AaaL4xiPwRbi4RdQWSIAIOiOZjog0ZMj70qhwwSU6/AVSrpn+LWgIOYT4R35bDsBiQ9enU0rUXfbY3Oskb844DeTsbMBbn3MAQ61b7lgt5YsCMk4E0BgJgq+nveLTOxAlTIyitpiMX3++EpupTmHcrxFQtalKKIyoKw0U9kFWWE+B7XVjrAHwCeuQE5Iw//G0SJW/0+GaOm8kro2zzFAopFsPV/q9SUq9YLL/vkTzOfh38XoyuoK+25W7zryPJIw9N7K0yOLfISWPk4hJuANI9DSSte5Aj/QF3zo57UZRDAAtJhvne0XXXfuqQJBkcw7Gfkym6nFBJtip7D78ePlhYNPOsRmnVyhBngZDyzIQSRnhkOcKI9BDMGLXncioTItGq6SPZ7rNy0zgcSJ+q2HGkFZsyWu1ZecEjp8OHEARLEyBye1JcOY2yeTjNhvED3ubGJyNzHwdmC9DkGOBPDJgzjGByyBMi7tN8tVf7HIDfhgM8ssuC3ad69DEEIu83J5eSpZRh3aUUPBW31mF8pi473MZ6LvJR8JoOy7En0pQzleg3SCZhw/mMs24DoJaZMPPlrBaPfaZIkPRfvur1dkM5HDQTgcl5RtB/9x1S4aYJxL5VgbXA5lTHY8RuD/zamQn0qEgduIZTJspN+9+o

属性选择器

O4+irCEf7Vue6JQTwhMEJJAq+1Jgvnn2Twamxz/txk3c45/5Z8hj6YTKiYTgPMZ34qIBp3c7dQeVCBzMZdjTP6JHVO6ZLzNEpLkl5LrUVZ13omfIS1zEQLZzpRViZdzj4AomyKMUE61iLnBppbEG0Q==

    bINY2qAjdyHrHEXRpX90tpLpx/Tb6vKpCRdGrCZPZxh0rdQqVViuYodbWuCwQNXi+O8krGbX8C/B+bjz2uwjwhRkqw9TcQWKLPi4TVegdd9ZnhmqFZl84xx+GoISC/CpWzu9t9ymQ9/BFGlWJg358zNwE4N0DtdODjU+P8WtTGUshAfd2l4kFy75LKNXfoBWveVeG/RMi7bLeI5wNsmF44npqn0x7Mw5s83dpbK06C+XddkfXMWnxC6BUUF+sAR6NmosFsfdyAby0tqOgisx11xinGP20nrTD+hhF+bDOeieQHIEIIJSzBdcAdKbSY9p9GY6XRhLb8leipuP7WS97RPMNqnqQCMRuJy2Ge/iiES15wWyiYZ59QmRcIN8/7nCifW88WeS3P8iuPqEz4R6UzHfp8te5fMM2w0WDG7yOsVtE8547dSNHVu160H/vWqW0nf+klXDLhUxPaOZOYK2eoksoPNveafdCDgpOO84VOcKhX6VqkredZg8SxWDw8xhj5oZYfqhEIBEF8DFKNaLhWwHbnZh2IhFFoTQgEXUipLUWlRKqC8lJQfpK1THwvzE6gHGWj9GOpPSCz0aLvy9+S3UkKaRfZQt+SqZ1FRY1Hq37YIAfgNBll87oTKVboAA

Array & Object 属性选择器

QZ+wbbSmUvdUzVcllwIYsAcPmkRgvaihe7kYKg0PAmTYu5SLYelM7i81x5xd6kydVzEU2O/eS7otpOhpM+yqt34xSwUOYbPoyyt/kUd9b5i9DwwFCd9lV1jSkXfWTNOKQcMPyXYa2MzO4Lg1YLiP82tNoez959UDcliOHNxKaoHGmIJAAenmGgwtppssXHYtqt75gtlzj1DGaMcRTk+f0FMngk1wAQk/YmY0OghwGEIjtEzE6iqu5oH2lX3Em3zf8BRq9PSKAi8S6WvZC2r/zy/xNDjOeLUyb2Rr6jyJeL9bUYGNDk2ubL+hCiFV/ZFWBYfbKZp6qkkNFPXcD7+WIlNsFCSEqVCksioX5wvlwPBgsbvb4KRxKsFTppvy7sVMY6KTOmWHefOfm87nJECsvo+BQN0aqw57bGpoj+ftlLRaYKKu15yLCUf8oA4BcwGXblnJ2koHjL7on2XuNeFWWtdjDaCLC27o90qFbWwN2sNmSgCf/4JuLn58tCIAUlUP+QpRu3uxVexQ9tH4bezAskT8vWKypkJoy9OOKpRVc14nCQCPkffdpxuYxrc5hKVM9QSuGb2bsD8rUR6vOqKj6PCrP5lOoO7BnW9jxbuqm5Wlollm4DOZbHiYhuXHpDo/mnN8nR+fyFPjoWEBpjlz7mh59Wxl9omJtvIY68htYRQ=

Objects

/* return dependencies that have a `scripts.test` containing `"tap"` */
*:attr(scripts, [test~=tap])

嵌套 Objects

MGLE8UuHRM0tVq3O21hBz8Qs8pznG3Dbffc/AKEWKO4tNrAdG0bMOZ9LYKS0eaBi+QHWZU2rP5F7ZXckVbzePQ==

/* return dependencies that have a testling config for opera browsers */
*:attr(testling, browsers, [~=opera])

Arrays

KCsaiB4XK6/sndsShSeUTNFUo43BRIjulR/1xdHTtd2i17aaVKZGr/yXloyxJImiDXJXcmi/zS7eUKBSo8/mr7H0NLt7iHXznlvuG8Bq2BOjk05BFx8BiLHOOv58OvzkHo/xA9SBlBup+0O9srvxx9IFujdVUOya+5ra624lxgm5ts1aCZjAjJxjmPQh6FLnX62bOJ1sl5DGebb6e+mUHIUJ6mOuznLW+XEAkpAxXUINuZz2XATANxDBwuWNU3mZwUfi9xhb//T6yrbybIzsesVGymENs1SU1rWvLJL3TQU=

Array 属性选择示例:

/* removes the distinction between properties & arrays */
/* ie. we'd have to check the property & iterate to match selection */
*:attr([keywords^=react])
*:attr(contributors, :attr([name~=Jordan]))

直接匹配值的 Array 示例:

/* return dependencies that have the exact keyword "react" */
/* this is equivalent to `*:keywords([value="react"])` */
*:attr([keywords=react])

Object 中的 Array 示例:

/* returns */
*:attr(contributors, [email=ruyadorno@github.com])

wvYEEpDk+6X8iQLh57z+2aiW6j5/49g/UUP1yv07KMs5/WA719S8iP7NqBp8vOzWxgoDFdXN5kBBfjM7cv4pxqdsla9+8PFbyYV8sEm58kAys0PFZyjm+s1Cm9RcA9/DNUQC4txWRGgyGHDVS9UtCgid+K8IxPfGk2NBz8dgj3REOUSa/N9OIak3mCrysKpD2T/7K+zW/T6AfYnoaS06MR4FTT5CLLVGB7AODk5gAsDnU900+Ynm+j6WI9rbx4OIuf+kq5ZFgE0SVoSUPxUh4dfxtTZb4qUkqe21SDUao3+lWdktYPsX3BUGROe0MrIvMhCOg50Xx30Qov5IfNFm2Clv1ANtz4PrhL5meIZ4Jz5+xR8rJLr0fQGuli8f55apTUjteEzlOYY7o1bLSx9VTAELD7wkHdMNkmNbF2L+UJMi6g3u3beRNQWAAKEi7XEXD8khoYRlb6lcDJlIG3/X+HcY0bj9X/5iqR0IbvXc1hFAUu6h5sd4YoiXWzDuulruZxdACqyeIoX1OndqaVtrGDL1tL1695Vp+/e9BSbh6+KaywMJkfA/I35VpCCsIhRYMW9KbXMmIcUMCJaUVTKID+qqvEkjIV47Pu6OhCWRmcpKUnJ/XrV/MMOfan96inElf0Mu+SapEZygy04N/lgVtzCAl1WuIi40WiXeJF+8ofQ=

    ruC5+jDDxHGlWFgApPWdepyvU9xKI8rMvoyq0uJJg5OucBEMdOeK7nhwhBuemNj9cWrJuoowAHM50vaUNjkn9ZfJg26sL0WihuD2seSuuHzgeo30HO0sAigiujcNyWF1d3vhVrTkfQ7SFAxpDjqEOh78jEf1TBu6Wnk9kaV7dnHGKcio2OMmjr9mbff1aq27og1j3fsPczdin4dFcuTTvch1gwh7PHkwr4B1cvjcZyJO44HZxZhFI/bTlN/ntSbz

DxfSpTIlb3Ig6rfiPuWAgLLvkP7wBbZ4dLRbWxREZ8k1kG/KhqRe+Wb0ZlycWO1NxgdApwLD3x5Bs1ZU0xQhasPbfn7hLyOeeopEeq90fz7/KThVLAf2TbpMIJbUfw3fMTNM2epRq/I1jc5FAH0/pa07GnrVz3hdKD22e3Qnw1Ntci1HwMp3g+n1d1wAfyaLEsJ1fn2M9ahpY8qS3LUiKbdh5bXlFvOidAkgVYDWw28=

程序化用法

    qt5feJov4nueOsFev170kRCOdFfkKFfSh9ZwyA7fDZB/ga6H/vJVjWS6e4jdVKTsbobfYC5Qhm1ugcB3oi2URQrew8k8QOUJHhJmfpOdoQyCYUcQ5l3U+cJGh/pa2f+OsQ7PfcNMdZTxkTzZEM67iEFKqpb8m4jM0gX5bKOZTyRW1HcR5vuK0PhNOXxrRDR1FKtwwRrbVOUh/oEhpbNQNO81l0v+xwVIlu4vhQ5m1VF6m4NhmsUtBonejd9d0zCrAcTYqMdVKuxItgSICQYramCb9jQ0DDsRVu5qVvahoKAi3K9evDZD8mcUBgXu5sMP
const Arborist = require('@npmcli/arborist')
const arb = new Arborist({})
// root-level
arb.loadActual().then(async (tree) => {
  // query all production dependencies
  const results = await tree.querySelectorAll('.prod')
  console.log(results)
})
// iterative
arb.loadActual().then(async (tree) => {
  // query for the deduped version of react
  const results = await tree.querySelectorAll('#react:not(:deduped)')
  // query the deduped react for git deps
  const deps = await results[0].querySelectorAll(':type(git)')
  console.log(deps)
})