The reason the docs don’t talk much about CSS selectors is that it is a standard. BTW this is open source, you are welcome to contribute pull-requests to improve the documentation.
UI automation is hard, I’m not going to claim that any framework makes it magically easier.
Suggestions:
- if not already, start using the VS Code debugger, you can type things like
highlight('div.panel-content')
into the interactive console and play around with the page. see a video demo here (55:40) https://youtu.be/yu3uupBZyxc?t=3340 - open the Chrome devtools console and type things like
document.querySelector('div.panel-content')
to see what gets matched - get a reference to any parent element and then you can “walk the tree”: https://github.com/intuit/karate/tree/master/karate-core#tree-walking
If still stuck, follow this process so that we can fix anything in the framework if needed: https://github.com/intuit/karate/wiki/How-to-Submit-an-Issue